ServiceSecurityAuditBehavior Kelas

Definisi

Ruang nama:

System.ServiceModel.Description

Rakitan:

System.ServiceModel.dll

Menentukan perilaku audit peristiwa keamanan. Secara umum, peristiwa keamanan terdiri dari peristiwa autentikasi seperti transportasi, pesan, atau menegosiasikan peristiwa autentikasi dan otorisasi. Untuk informasi selengkapnya, lihat 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

Warisan

Object

ServiceSecurityAuditBehavior

Penerapan

IServiceBehavior

Contoh

Kode berikut membuat instans ServiceHost kelas dan menambahkan yang baru ServiceSecurityAuditBehavior ke kumpulan perilakunya.

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

Keterangan

Kelas ServiceSecurityAuditBehavior ini digunakan untuk mengaudit peristiwa autentikasi Windows Communication Foundation (WCF). Saat audit diaktifkan, upaya autentikasi yang berhasil atau gagal (atau keduanya) dapat diaudit. Peristiwa ditulis ke salah satu dari tiga log peristiwa: aplikasi, keamanan, atau log default untuk versi sistem operasi. Semua log kejadian dapat dilihat menggunakan penampil Peristiwa Windows.

Gunakan kelas ini untuk menentukan log peristiwa mana yang ditulis, serta jenis peristiwa autentikasi untuk ditulis. Anda juga dapat menentukan apakah akan menekan kegagalan audit dengan mengatur properti ke SuppressAuditFailurefalse (defaultnya adalah true).

Untuk informasi selengkapnya tentang mengaudit peristiwa keamanan untuk aplikasi WCF, lihat Audit.

Untuk menentukan perilaku audit dalam konfigurasi, gunakan <serviceSecurityAudit>.

Konstruktor

Nama	Deskripsi
ServiceSecurityAuditBehavior()	Menginisialisasi instans baru dari kelas ServiceSecurityAuditBehavior.

Properti

Nama	Deskripsi
AuditLogLocation	Mendapatkan atau mengatur lokasi tempat log peristiwa terkait aman ditulis.
MessageAuthenticationAuditLevel	Mendapatkan atau mengatur jenis peristiwa autentikasi untuk diaudit di tingkat pesan.
ServiceAuthorizationAuditLevel	Mendapatkan atau mengatur jenis peristiwa otorisasi untuk diaudit di tingkat layanan.
SuppressAuditFailure	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kegagalan audit memengaruhi aplikasi.

Metode

Nama	Deskripsi
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

Nama	Deskripsi
IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	Meneruskan data kustom ke elemen pengikatan untuk mendukung implementasi kontrak.
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	Menyediakan kemampuan untuk mengubah nilai properti run-time atau menyisipkan objek ekstensi kustom seperti penangan kesalahan, pencegat pesan atau parameter, ekstensi keamanan, dan objek ekstensi kustom lainnya.
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	Tidak diterapkan.