ServiceSecurityAuditBehavior Osztály

Definíció

Névtér:

System.ServiceModel.Description

Szerelvény:

System.ServiceModel.dll

A biztonsági események naplózási viselkedését határozza meg. A biztonsági események általában olyan hitelesítési eseményekből állnak, mint az átvitel, az üzenet vagy a hitelesítés és az engedélyezési esemény egyeztetése. További információért lásd 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

Öröklődés

Object

ServiceSecurityAuditBehavior

Megvalósítás

IServiceBehavior

Példák

Az alábbi kód létrehozza az ServiceHost osztály egy példányát, és hozzáad egy újat ServiceSecurityAuditBehavior a viselkedésgyűjteményéhez.

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

Megjegyzések

A ServiceSecurityAuditBehavior osztály a Windows kommunikációs alaprendszer (WCF) hitelesítési események naplózására szolgál. Ha a naplózás engedélyezve van, a sikeres vagy sikertelen hitelesítési kísérletek (vagy mindkettő) naplózhatók. Az eseményeket a rendszer három eseménynapló egyikére írja: alkalmazásra, biztonságra vagy az operációs rendszer verziójának alapértelmezett naplójára. Az eseménynaplók mind megtekinthetők a Windows Eseménynapló használatával.

Ebben az osztályban megadhatja, hogy melyik eseménynaplóba van beírva, valamint hogy milyen típusú hitelesítési eseményeket írjon. Azt is megadhatja, hogy el kívánja-e tiltani a naplózási hibákat a SuppressAuditFailure tulajdonság false beállításával (az alapértelmezett érték true).

További információ a WCF-alkalmazások biztonsági eseményeinek naplózásáról: Naplózás.

A konfiguráció naplózási viselkedésének megadásához használja a <serviceSecurityAudit parancsot>.

Konstruktorok

Név	Description
ServiceSecurityAuditBehavior()	Inicializálja a ServiceSecurityAuditBehavior osztály új példányát.

Tulajdonságok

Név	Description
AuditLogLocation	Lekéri vagy beállítja a biztonságos eseménynaplók írási helyét.
MessageAuthenticationAuditLevel	Lekéri vagy beállítja az üzenet szintjén naplózandó hitelesítési események típusát.
ServiceAuthorizationAuditLevel	Lekéri vagy beállítja a szolgáltatás szintjén naplózandó engedélyezési események típusát.
SuppressAuditFailure	Lekéri vagy beállít egy értéket, amely jelzi, hogy a naplózás sikertelensége hatással van-e az alkalmazásra.

Metódusok

Név	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Név	Description
IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Egyéni adatokat ad át kötési elemeknek a szerződés végrehajtásának támogatásához.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Lehetővé teszi a futásidejű tulajdonságértékek módosítását vagy egyéni bővítményobjektumok, például hibakezelők, üzenet- vagy paraméterelfogók, biztonsági bővítmények és egyéb egyéni bővítményobjektumok beszúrását.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Nincs implementálva.