ServiceSecurityAuditBehavior ServiceSecurityAuditBehavior ServiceSecurityAuditBehavior ServiceSecurityAuditBehavior Class

定義

セキュリティ イベントの監査動作を指定します。Specifies the audit behavior of security events. セキュリティ イベントは通常、トランスポート認証、メッセージ認証、ネゴシエート認証などの認証イベントと承認イベントで構成されます。In general, the security events consist of authentication events such as transport, message or negotiate authentication and authorization event. 詳細については、「ServiceAuthorizationManager」を参照してください。For more information, see ServiceAuthorizationManager.

public ref class ServiceSecurityAuditBehavior sealed : System::ServiceModel::Description::IServiceBehavior
public sealed class ServiceSecurityAuditBehavior : System.ServiceModel.Description.IServiceBehavior
type ServiceSecurityAuditBehavior = class
    interface IServiceBehavior
Public NotInheritable Class ServiceSecurityAuditBehavior
Implements IServiceBehavior
継承
ServiceSecurityAuditBehaviorServiceSecurityAuditBehaviorServiceSecurityAuditBehaviorServiceSecurityAuditBehavior
実装

ServiceHost クラスのインスタンスを作成し、新しい ServiceSecurityAuditBehavior をその動作のコレクションに追加するコード例を次に示します。The following code creates an instance of the ServiceHost class and adds a new ServiceSecurityAuditBehavior to its collection of behaviors.

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 

注釈

ServiceSecurityAuditBehaviorクラスは、Windows Communication Foundation (WCF) 認証イベントの監査に使用されます。The ServiceSecurityAuditBehavior class is used to audit Windows Communication Foundation (WCF) authentication events. 監査を有効にすると、成功した認証、失敗した認証、またはその両方を監査できます。When auditing is enabled, either successful or failed authentication attempts (or both) can be audited. イベントは、3 種類のイベント ログ (アプリケーション ログ、セキュリティ ログ、およびオペレーティング システムのバージョンに対する既定のログ) のいずれかに書き込まれます。The events are written to one of three event logs: application, security, or the default log for the operating system version. イベント ログはすべて、Windows イベント ビューアーを使用して表示できます。The event logs can all be viewed using the Windows Event viewer.

このクラスを使用して、書き込み先のイベント ログと書き込む認証イベントの種類を指定します。Use this class to specify which event log is written to, as well as kinds of authentication events to write. また、SuppressAuditFailure プロパティ (既定値は false) を true に設定することにより、監査エラーを非表示にするかどうかを指定することもできます。You can also specify whether to suppress audit failures by setting the SuppressAuditFailure property to false (the default is true).

WCF アプリケーションのセキュリティ イベントの監査の詳細については、次を参照してください。監査します。For more information about auditing security events for WCF applications, see Auditing.

構成で監査動作を指定するには、使用、 <serviceSecurityAudit>します。To specify audit behavior in configuration, use the <serviceSecurityAudit>.

コンストラクター

ServiceSecurityAuditBehavior() ServiceSecurityAuditBehavior() ServiceSecurityAuditBehavior() ServiceSecurityAuditBehavior()

ServiceSecurityAuditBehavior クラスの新しいインスタンスを初期化します。Initializes a new instance of the ServiceSecurityAuditBehavior class.

プロパティ

AuditLogLocation AuditLogLocation AuditLogLocation AuditLogLocation

セキュリティ関連のイベント ログが書き込まれる場所を取得または設定します。Gets or sets the location where secure-related event logs are written.

MessageAuthenticationAuditLevel MessageAuthenticationAuditLevel MessageAuthenticationAuditLevel MessageAuthenticationAuditLevel

メッセージ レベルで監査する認証イベントの種類を取得または設定します。Gets or sets the type of authentication events to audit at the message level.

ServiceAuthorizationAuditLevel ServiceAuthorizationAuditLevel ServiceAuthorizationAuditLevel ServiceAuthorizationAuditLevel

サービス レベルで監査する承認イベントの種類を取得または設定します。Gets or sets the type of authorization events to audit at the service level.

SuppressAuditFailure SuppressAuditFailure SuppressAuditFailure SuppressAuditFailure

監査の失敗がアプリケーションに影響を及ぼすかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether failure to audit affects the application.

明示的なインターフェイスの実装

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection) IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)

コントラクトの実装をサポートするカスタム データをバインド要素に渡します。Passes custom data to binding elements to support the contract implementation.

IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase) IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)

ランタイム プロパティの値を変更したり、エラー ハンドラー、メッセージ インターセプター、パラメーター インターセプター、セキュリティ拡張などのカスタム拡張オブジェクトを挿入したりできるようにします。Provides the ability to change run-time property values or insert custom extension objects such as error handlers, message or parameter interceptors, security extensions, and other custom extension objects.

IServiceBehavior.Validate(ServiceDescription, ServiceHostBase) IServiceBehavior.Validate(ServiceDescription, ServiceHostBase) IServiceBehavior.Validate(ServiceDescription, ServiceHostBase) IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)

実装されていません。Not implemented.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象