Condividi tramite


ServiceSecurityAuditBehavior Classe

Definizione

Specifica il comportamento di controllo degli eventi di sicurezza. In generale, gli eventi di sicurezza sono costituiti da eventi di autenticazione, ad esempio trasporto, messaggio o negoziazione dell'autenticazione e dell'evento di autorizzazione. 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à
ServiceSecurityAuditBehavior
Implementazioni

Esempio

Il codice seguente crea un'istanza della ServiceHost classe e aggiunge un nuovo ServiceSecurityAuditBehavior oggetto alla raccolta di 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 è abilitato, è possibile controllare i tentativi di autenticazione riusciti o non riusciti (o entrambi). Gli eventi vengono scritti in uno dei tre registri eventi: applicazione, sicurezza o log predefinito per la versione del sistema operativo. I registri eventi possono essere visualizzati tutti usando il Visualizzatore eventi di Windows.

Usare questa classe per specificare il registro eventi in cui scrivere, nonché i tipi di eventi di autenticazione da scrivere. È anche possibile specificare se eliminare gli errori di controllo impostando la SuppressAuditFailure proprietà su false (il valore predefinito è 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

Nome Descrizione
ServiceSecurityAuditBehavior()

Inizializza una nuova istanza della classe ServiceSecurityAuditBehavior.

Proprietà

Nome Descrizione
AuditLogLocation

Ottiene o imposta il percorso in cui vengono scritti i registri eventi correlati alla protezione.

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 l'errore di controllo influisce sull'applicazione.

Metodi

Nome Descrizione
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 il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

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

Passa dati personalizzati agli elementi di associazione per supportare l'implementazione del contratto.

IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)

Consente di modificare i valori delle proprietà di runtime o di inserire oggetti di estensione personalizzati, ad esempio gestori di errori, intercettori di messaggi o parametri, estensioni di sicurezza e altri oggetti di estensione personalizzati.

IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)

Non implementata.

Si applica a