ServiceSecurityAuditBehavior Classe

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.dll

Spécifie le comportement d'audit d'événements de sécurité. En règle générale, les événements de sécurité se composent d'événements d'authentification tels que le transport, le message ou la négociation d'un événement d'authentification et d'autorisation. Pour plus d'informations, consultez 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

Héritage

Object

ServiceSecurityAuditBehavior

Implémente

IServiceBehavior

Exemples

Le code suivant crée une instance de la classe ServiceHost et ajoute un nouveau ServiceSecurityAuditBehavior à sa collection de comportements.

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

Remarques

La ServiceSecurityAuditBehavior classe est utilisée pour auditer les événements d’authentification Windows Communication Foundation (WCF). Lorsque l'audit est activé, il est possible de réaliser l'audit des tentatives d'authentification réussies ou échouées (ou les deux). Les événements sont écrits dans l'un des trois journaux des événements : application, sécurité ou journal par défaut de la version du système d'exploitation. Les journaux des événements peuvent être consultés à l'aide de l'Observateur d'événements Windows.

Utilisez cette classe pour spécifier le journal des événements concerné par l'écriture, ainsi que les types d'événements d'authentification à écrire. Vous pouvez également indiquer que les échecs d'audit doivent être supprimés en affectant la valeur SuppressAuditFailure à la propriété false (la valeur par défaut est true).

Pour plus d’informations sur l’audit des événements de sécurité pour les applications WCF, consultez Audit.

Pour spécifier le comportement d’audit dans la configuration, utilisez serviceSecurityAudit<>.

Constructeurs

ServiceSecurityAuditBehavior()

Initialise une nouvelle instance de la classe ServiceSecurityAuditBehavior.

Propriétés

AuditLogLocation	Obtient ou définit l'emplacement où les journaux des événements relatifs à la sécurité sont écrits.
MessageAuthenticationAuditLevel	Obtient ou définit le type d'événements d'authentification dont l'audit doit être réalisé au niveau du message.
ServiceAuthorizationAuditLevel	Obtient ou définit le type d'événements d'autorisation dont l'audit doit être réalisé au niveau du service.
SuppressAuditFailure	Obtient ou définit une valeur qui indique si l'échec d'audit affecte l'application.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Passe des données personnalisées à des éléments de liaison pour prendre en charge l’implémentation de contrat.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Fournit la possibilité de modifier des valeurs de propriété d'exécution ou insérer des objets d'extensions personnalisées tels que les gestionnaires d'erreurs, les intercepteurs de messages ou de paramètres, les extensions de sécurité et autres objets d'extensions personnalisées.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Non implémenté.