HOW TO：稽核 Windows Communication Foundation 安全性事件

發行項
05/22/2023

Windows Communication Foundation (WCF) 可讓您將安全性事件記錄至 Windows 事件記錄檔，而您可以使用 Windows 事件檢視器來檢視事件記錄檔。這個主題會說明如何將應用程式設定為會記錄安全性事件。如需 WCF 稽核的詳細資訊，請參閱稽核。

若要在程式碼中稽核安全性事件

指定稽核記錄檔位置。若要這樣做，請將 AuditLogLocation 類別的 ServiceSecurityAuditBehavior 屬性設定為其中一個 AuditLogLocation 列舉值，如下列程式碼所示。
```
// Create a new auditing behavior and set the log location.
ServiceSecurityAuditBehavior newAudit =
    new ServiceSecurityAuditBehavior();
newAudit.AuditLogLocation =
    AuditLogLocation.Application;
```
```
' Create a new auditing behavior and set the log location.
Dim newAudit As New ServiceSecurityAuditBehavior()
newAudit.AuditLogLocation = AuditLogLocation.Application
```
AuditLogLocation 列舉中有三個值：Application、Security 或 Default。該值會指定可在事件檢視器中看見安全性記錄檔或應用程式記錄檔。如果使用 Default 值，實際的記錄檔將會取決於正在執行應用程式的作業系統。如果已啟用稽核，但未指定記錄檔位置，則支援寫入至安全性記錄檔的平台會預設使用 Security 記錄檔，不支援這個動作的平台則會寫入至 Application 記錄檔。根據預設，只有 Windows Server 2003 和 Windows Vista 支援寫入安全性記錄。

設定要稽核的事件類型。您可以同時稽核服務層級事件或訊息層級的授權事件。若要這樣做，請將 ServiceAuthorizationAuditLevel 屬性或 MessageAuthenticationAuditLevel 屬性設定為其中一個 AuditLevel 列舉值，如下列程式碼所示。

// Create a new auditing behavior and set the log location.
ServiceSecurityAuditBehavior newAudit =
    new ServiceSecurityAuditBehavior();
newAudit.AuditLogLocation =
    AuditLogLocation.Application;
newAudit.MessageAuthenticationAuditLevel =
    AuditLevel.SuccessOrFailure;
newAudit.ServiceAuthorizationAuditLevel =
    AuditLevel.SuccessOrFailure;

newAudit.MessageAuthenticationAuditLevel = _
    AuditLevel.SuccessOrFailure
newAudit.ServiceAuthorizationAuditLevel = _
    AuditLevel.SuccessOrFailure

指定是否要對與記錄稽核事件相關的應用程式隱藏或公開錯誤。將 SuppressAuditFailure 屬性設定為 true 或 false，如下列程式碼所示。

// Create a new auditing behavior and set the log location.
ServiceSecurityAuditBehavior newAudit =
    new ServiceSecurityAuditBehavior();
newAudit.AuditLogLocation =
    AuditLogLocation.Application;
newAudit.MessageAuthenticationAuditLevel =
    AuditLevel.SuccessOrFailure;
newAudit.ServiceAuthorizationAuditLevel =
    AuditLevel.SuccessOrFailure;
newAudit.SuppressAuditFailure = false;

newAudit.SuppressAuditFailure = False

預設 SuppressAuditFailure 屬性為 true，因此稽核錯誤不至於影響應用程式。否則，會擲回例外狀況。任何成功稽核的詳細資訊追蹤都會予以寫入，而任何稽核失敗的追蹤則會在「錯誤」層級寫入。

從 ServiceSecurityAuditBehavior 的描述中出現的行為集合，刪除現有的 ServiceHost。該行為集合是由 Behaviors 屬性存取，接下來則是從 Description 屬性存取。接著將 ServiceSecurityAuditBehavior 新增至相同的集合，如下列程式碼所示。

// Remove the old behavior and add the new.
serviceHost.Description.
    Behaviors.Remove<ServiceSecurityAuditBehavior>();
serviceHost.Description.Behaviors.Add(newAudit);

' Remove the old behavior and add the new.
serviceHost.Description.Behaviors.Remove(Of ServiceSecurityAuditBehavior)
serviceHost.Description.Behaviors.Add(newAudit)

若要使用組態設定稽核

若要在組態中設定稽核，請將 <behavior> 元素新增至 web.config 檔案的 <behaviors> 區段。然後，新增 <serviceSecurityAudit> 元素並設定各種屬性，如下列範例所示。

<behaviors>  
   <behavior name="myAuditBehavior">  
      <serviceSecurityAudit auditLogLocation="Application"  
            suppressAuditFailure="false"
            serviceAuthorizationAuditLevel="None"
            messageAuthenticationAuditLevel="SuccessOrFailure" />  
      </behavior>  
</behaviors>

您必須指定服務的行為，如下列範例所示。

<services>  
    <service type="WCS.Samples.Service.Echo"
    behaviorConfiguration=" myAuditBehavior">  
       <endpoint address=""  
                binding="wsHttpBinding"  
                bindingConfiguration="CertificateDefault"
                contract="WCS.Samples.Service.IEcho" />  
    </service>  
</services>

範例

下列程式碼會建立 ServiceHost 類別的執行個體，並且將 ServiceSecurityAuditBehavior 新增至其行為集合。

public static void Main()
{
    // Get base address from appsettings in configuration.
    Uri baseAddress = new Uri(ConfigurationManager.
        AppSettings["baseAddress"]);

    // Create a ServiceHost for the CalculatorService type
    // and provide the base address.
    using (ServiceHost serviceHost = new
        ServiceHost(typeof(CalculatorService), baseAddress))
    {
        // Create a new auditing behavior and set the log location.
        ServiceSecurityAuditBehavior newAudit =
            new ServiceSecurityAuditBehavior();
        newAudit.AuditLogLocation =
            AuditLogLocation.Application;
        newAudit.MessageAuthenticationAuditLevel =
            AuditLevel.SuccessOrFailure;
        newAudit.ServiceAuthorizationAuditLevel =
            AuditLevel.SuccessOrFailure;
        newAudit.SuppressAuditFailure = false;
        // Remove the old behavior and add the new.
        serviceHost.Description.
            Behaviors.Remove<ServiceSecurityAuditBehavior>();
        serviceHost.Description.Behaviors.Add(newAudit);
        // Open the ServiceHostBase to create listeners
        // and start listening for messages.
        serviceHost.Open();

        // The service can now be accessed.
        Console.WriteLine("The service is ready.");
        Console.WriteLine("Press <ENTER> to terminate service.");
        Console.WriteLine();
        Console.ReadLine();

        // Close the ServiceHostBase to shutdown the service.
        serviceHost.Close();
    }
}

Public Shared Sub Main()
    ' Get base address from appsettings in configuration.
    Dim baseAddress As New Uri(ConfigurationManager.AppSettings("baseAddress"))

    ' Create a ServiceHost for the CalculatorService type 
    ' and provide the base address.
    Dim serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
    Try
        ' Create a new auditing behavior and set the log location.
        Dim newAudit As New ServiceSecurityAuditBehavior()
        newAudit.AuditLogLocation = AuditLogLocation.Application
        newAudit.MessageAuthenticationAuditLevel = _
            AuditLevel.SuccessOrFailure
        newAudit.ServiceAuthorizationAuditLevel = _
            AuditLevel.SuccessOrFailure
        newAudit.SuppressAuditFailure = False
        ' Remove the old behavior and add the new.
        serviceHost.Description.Behaviors.Remove(Of ServiceSecurityAuditBehavior)
        serviceHost.Description.Behaviors.Add(newAudit)
        ' Open the ServiceHostBase to create listeners 
        ' and start listening for messages.
        serviceHost.Open()

        ' The service can now be accessed.
        Console.WriteLine("The service is ready.")
        Console.WriteLine("Press <ENTER> to terminate service.")
        Console.WriteLine()
        Console.ReadLine()

        ' Close the ServiceHostBase to shutdown the service.
        serviceHost.Close()
    Finally
    End Try

End Sub

.NET Framework 安全性

如果將 SuppressAuditFailure 屬性設定為 true，就會隱藏產生安全性稽核時的失敗 (如果設定為 false，就會擲回例外狀況)。不過，如果啟用下列 Windows [本機安全性設定] 屬性，無法產生稽核事件就會導致 Windows 立即關機：

稽核：當無法記錄安全性稽核時，系統立即關機

若要設定屬性，請開啟 [本機安全性設定] 對話方塊。按一下 [安全性設定] 下的 [本機原則]。然後按一下 [安全性選項]。

如果 AuditLogLocation 屬性設為 Security，且 [本機安全性原則] 中的 [稽核物件存取] 未設定，則稽核事件不會寫入安全性記錄。請注意，這時不會傳回任何失敗，但是稽核項目也不會寫入安全性記錄檔中。

共用方式為

HOW TO：稽核 Windows Communication Foundation 安全性事件

若要在程式碼中稽核安全性事件

若要使用組態設定稽核

範例

.NET Framework 安全性

另請參閱

其他資源