ServiceSecurityAuditBehavior Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Description

Assembly:

System.ServiceModel.dll

Specifica il comportamento di controllo degli eventi di sicurezza. In generale, gli eventi di sicurezza sono costituiti da eventi di autenticazione e autorizzazione di trasporto, messaggi o negoziazione. Per altre informazioni, vedere 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

Ereditarietà

Object

ServiceSecurityAuditBehavior

Implementazioni

IServiceBehavior

Esempio

Nel codice seguente viene creata un'istanza della classe ServiceHost e viene aggiunta una nuova classe ServiceSecurityAuditBehavior alla raccolta dei comportamenti.

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

Commenti

La ServiceSecurityAuditBehavior classe viene usata per controllare gli eventi di autenticazione di Windows Communication Foundation (WCF). Quando il controllo è attivato, è possibile controllare tentativi di autenticazione riusciti o con errori (o entrambi). Gli eventi vengono scritti in uno di tre registri eventi (applicazione, sicurezza o predefinito) in base alla versione del sistema operativo. I registri eventi possono essere tutti visualizzati con il Visualizzatore eventi di Windows.

Utilizzare questa classe per specificare il registro eventi in cui scrivere nonché i tipi di eventi di autenticazione da scrivere. È inoltre possibile specificare se sopprimere errori di controllo impostando la proprietà SuppressAuditFailure su false (l'impostazione predefinita è true).

Per altre informazioni sul controllo degli eventi di sicurezza per le applicazioni WCF, vedere Controllo.

Per specificare il comportamento di controllo nella configurazione, usare il< servizioSecurityAudit>.

Costruttori

ServiceSecurityAuditBehavior()

Inizializza una nuova istanza della classe ServiceSecurityAuditBehavior.

Proprietà

AuditLogLocation	Ottiene o imposta il percorso in cui vengono scritti i log eventi di sicurezza.
MessageAuthenticationAuditLevel	Ottiene o imposta il tipo di eventi di autenticazione da controllare a livello di messaggio.
ServiceAuthorizationAuditLevel	Ottiene o imposta il tipo di eventi di autorizzazione da controllare a livello di servizio.
SuppressAuditFailure	Ottiene o imposta un valore che indica se il mancato controllo esercita un effetto sull'applicazione.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Passa i dati personalizzati agli elementi di associazione per supportare l'implementazione del contratto.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Consente di modificare i valori delle proprietà della fase di esecuzione o inserire oggetti di estensione personalizzati, ad esempio gestori di errori, intercettatori di messaggi o parametri, estensioni di sicurezza e altri oggetti di estensione personalizzati.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Non implementato.