ServiceSecurityAuditBehavior Sınıf

Tanım

Ad Alanı:

System.ServiceModel.Description

Bütünleştirilmiş Kod:

System.ServiceModel.dll

Güvenlik olaylarının denetim davranışını belirtir. Genel olarak, güvenlik olayları aktarım, ileti veya anlaşma kimlik doğrulaması ve yetkilendirme olayı gibi kimlik doğrulama olaylarından oluşur. Daha fazla bilgi için bkz. 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

Devralma

Object

ServiceSecurityAuditBehavior

Uygulamalar

IServiceBehavior

Örnekler

Aşağıdaki kod sınıfın bir örneğini ServiceHost oluşturur ve davranış koleksiyonuna yeni ServiceSecurityAuditBehavior bir ekler.

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

Açıklamalar

ServiceSecurityAuditBehavior sınıfı, Windows Communication Foundation (WCF) kimlik doğrulama olaylarını denetlemek için kullanılır. Denetim etkinleştirildiğinde, başarılı veya başarısız kimlik doğrulama girişimleri (veya her ikisi de) denetlenebilir. Olaylar üç olay günlüğünden birine yazılır: uygulama, güvenlik veya işletim sistemi sürümü için varsayılan günlük. Olay günlüklerinin tümü Windows Olay görüntüleyicisi kullanılarak görüntülenebilir.

Yazılacak kimlik doğrulama olaylarının türlerinin yanı sıra, hangi olay günlüğüne yazılacağını belirtmek için bu sınıfı kullanın. Özelliğini false olarak ayarlayarak denetim hatalarının gizlenip gizlenmeyeceğini SuppressAuditFailure de belirtebilirsiniz (varsayılan değerdirtrue).

WCF uygulamaları için güvenlik olaylarını denetleme hakkında daha fazla bilgi için bkz. Denetim.

Yapılandırmada denetim davranışını belirtmek için serviceSecurityAudit> kullanın.<

Oluşturucular

ServiceSecurityAuditBehavior()

ServiceSecurityAuditBehavior sınıfının yeni bir örneğini başlatır.

Özellikler

AuditLogLocation	Güvenli olay günlüklerinin yazıldığı konumu alır veya ayarlar.
MessageAuthenticationAuditLevel	İleti düzeyinde denetlenecek kimlik doğrulama olaylarının türünü alır veya ayarlar.
ServiceAuthorizationAuditLevel	Hizmet düzeyinde denetlenecek yetkilendirme olaylarının türünü alır veya ayarlar.
SuppressAuditFailure	Denetim hatasının uygulamayı etkileyip etkilemediğini belirten bir değer alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Özel verileri, sözleşme uygulamasını desteklemek için bağlama öğelerine geçirir.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Çalışma zamanı özellik değerlerini değiştirme veya hata işleyicileri, ileti veya parametre kesme makineleri, güvenlik uzantıları ve diğer özel uzantı nesneleri gibi özel uzantı nesneleri ekleme olanağı sağlar.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Uygulanmaz.