ServiceSecurityAuditBehavior Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel.Description

Zestaw:

System.ServiceModel.dll

Określa zachowanie inspekcji zdarzeń zabezpieczeń. Ogólnie rzecz biorąc, zdarzenia zabezpieczeń składają się z zdarzeń uwierzytelniania, takich jak transport, komunikat lub negocjuj uwierzytelnianie i zdarzenie autoryzacji. Aby uzyskać więcej informacji, zobacz 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

Dziedziczenie

Object

ServiceSecurityAuditBehavior

Implementuje

IServiceBehavior

Przykłady

Poniższy kod tworzy wystąpienie ServiceHost klasy i dodaje nowe ServiceSecurityAuditBehavior do swojej kolekcji zachowań.

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

Uwagi

Klasa ServiceSecurityAuditBehavior służy do inspekcji zdarzeń uwierzytelniania Windows Communication Foundation (WCF). Po włączeniu inspekcji można przeprowadzić inspekcję prób uwierzytelnienia zakończonych powodzeniem lub niepowodzeniem (lub obu). Zdarzenia są zapisywane w jednym z trzech dzienników zdarzeń: aplikacji, zabezpieczeń lub domyślnego dziennika wersji systemu operacyjnego. Wszystkie dzienniki zdarzeń można wyświetlić za pomocą podglądu zdarzeń Windows.

Użyj tej klasy, aby określić, do którego dziennika zdarzeń jest zapisywany, a także rodzaje zdarzeń uwierzytelniania do zapisu. Można również określić, czy należy pominąć błędy inspekcji, ustawiając SuppressAuditFailure właściwość na false wartość (wartość domyślna to true).

Aby uzyskać więcej informacji na temat inspekcji zdarzeń zabezpieczeń dla aplikacji WCF, zobacz Inspekcja.

Aby określić zachowanie inspekcji w konfiguracji, użyj <elementu serviceSecurityAudit>.

Konstruktory

ServiceSecurityAuditBehavior()

Inicjuje nowe wystąpienie klasy ServiceSecurityAuditBehavior.

Właściwości

AuditLogLocation	Pobiera lub ustawia lokalizację zapisywania dzienników zdarzeń związanych z zabezpieczeniami.
MessageAuthenticationAuditLevel	Pobiera lub ustawia typ zdarzeń uwierzytelniania do inspekcji na poziomie komunikatu.
ServiceAuthorizationAuditLevel	Pobiera lub ustawia typ zdarzeń autoryzacji do inspekcji na poziomie usługi.
SuppressAuditFailure	Pobiera lub ustawia wartość wskazującą, czy inspekcja nie ma wpływu na aplikację.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Przekazuje dane niestandardowe do elementów powiązania w celu obsługi implementacji kontraktu.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Umożliwia zmianę wartości właściwości czasu wykonywania lub wstawianie niestandardowych obiektów rozszerzeń, takich jak programy obsługi błędów, przechwytywanie komunikatów lub parametrów, rozszerzenia zabezpieczeń i inne niestandardowe obiekty rozszerzeń.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Nie zaimplementowano.