ServiceSecurityAuditBehavior Třída

Definice

Obor názvů:

System.ServiceModel.Description

Sestavení:

System.ServiceModel.dll

Určuje auditní chování událostí zabezpečení. Obecně platí, že události zabezpečení se skládají z událostí ověřování, jako je přenos, zpráva nebo vyjednat ověřování a autorizační událost. Další informace najdete na webu 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

Dědičnost

Object

ServiceSecurityAuditBehavior

Implementuje

IServiceBehavior

Příklady

Následující kód vytvoří instanci ServiceHost třídy a přidá novou ServiceSecurityAuditBehavior kolekci chování.

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

Poznámky

Třída ServiceSecurityAuditBehavior se používá k auditování událostí ověřování WCF (Windows Communication Foundation). Pokud je auditování povolené, je možné auditovat úspěšné nebo neúspěšné pokusy o ověření (nebo obojí). Události se zapisují do jednoho ze tří protokolů událostí: aplikace, zabezpečení nebo výchozí protokol pro verzi operačního systému. Všechny protokoly událostí lze zobrazit pomocí prohlížeče událostí systému Windows.

Pomocí této třídy můžete určit, do kterého protokolu událostí se zapisuje, a také druhy událostí ověřování, které se mají zapisovat. Můžete také určit, zda chcete potlačit selhání auditu nastavením SuppressAuditFailure vlastnosti ( false výchozí hodnota je true).

Další informace o auditování událostí zabezpečení pro aplikace WCF naleznete v tématu Auditování.

Pokud chcete určit chování auditu v konfiguraci, použijte <serviceSecurityAudit>.

Konstruktory

Name	Description
ServiceSecurityAuditBehavior()	Inicializuje novou instanci ServiceSecurityAuditBehavior třídy.

Vlastnosti

Name	Description
AuditLogLocation	Získá nebo nastaví umístění, kde se zapisují protokoly událostí související se zabezpečením.
MessageAuthenticationAuditLevel	Získá nebo nastaví typ událostí ověřování, které se mají auditovat na úrovni zprávy.
ServiceAuthorizationAuditLevel	Získá nebo nastaví typ událostí autorizace pro audit na úrovni služby.
SuppressAuditFailure	Získá nebo nastaví hodnotu, která označuje, zda selhání auditování ovlivňuje aplikaci.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Předá vlastní data do vazeb prvků, které podporují implementaci kontraktu.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Poskytuje možnost změnit hodnoty vlastností za běhu nebo vložit vlastní objekty rozšíření, jako jsou obslužné rutiny chyb, zachytávání zpráv nebo zachytávání parametrů, rozšíření zabezpečení a další vlastní objekty rozšíření.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Není implementováno.