WebAuthenticationSuccessAuditEvent Kelas

Definisi

Menyediakan informasi tentang peristiwa autentikasi yang berhasil.

public class WebAuthenticationSuccessAuditEvent : System.Web.Management.WebSuccessAuditEvent
Warisan

Contoh

Contoh kode ini memiliki dua bagian: kutipan file konfigurasi, diikuti dengan kode yang menunjukkan cara menyesuaikan WebAuthenticationSuccessAuditEvent peristiwa.

Berikut ini adalah kutipan dari bagian dan eventMappings file provider konfigurasi. Mereka sudah diatur secara default. Satu-satunya hal yang perlu Anda lakukan adalah menyediakan penyiapan untuk rules elemen di bagian tersebut healthMonitoring .

<healthMonitoring  
  enabled="true"  
  heartBeatInterval="0">  

    <providers>  
      // Configure the provider to process   
      // the health events.  
      <add name="EventLogProvider"  
         type="System.Web.Management.EventLogWebEventProvider,  
         System.Web,Version=2.0.3600.0,Culture=neutral,  
         PublicKeyToken=b03f5f7f11d50a3a"/>  
    </providers>  

    <eventMappings>  
       <clear />  
       // Configure the custom event   
       // to handle the audit events.   
        <add name="SampleWebAuthenticationSuccessAuditEvent"   
          type="SamplesAspNet.SampleWebAuthenticationSuccessAuditEvent,  
          webauthsuccessaudit, Version=1.0.1735.23144, Culture=neutral,   
          PublicKeyToken=dd969eda3f3f6ae1, processorArchitecture=MSIL" />  

     </eventMappings>  
     <rules>  
       <clear/>  
       // Establish the connection between custom event   
       // and the provider that must process it.  
      <add name="Log Authentication Success Audits"   
        eventName="SampleWebAuthenticationFailureAuditEvent"  
        provider="EventLogProvider"   
        profile="Custom" />\  
     </rules>  

</healthMonitoring>  

Kode berikut menunjukkan cara mengkustomisasi WebAuthenticationSuccessAuditEvent peristiwa.


using System;
using System.Text;
using System.Web;
using System.Web.Management;

namespace SamplesAspNet
{
    // Implements a custom WebAuthenticationSuccessAuditEvent class. 
    public class SampleWebAuthenticationSuccessAuditEvent : 
        System.Web.Management.WebAuthenticationSuccessAuditEvent
    {
        private string customCreatedMsg, customRaisedMsg;

        // Invoked in case of events identified only by their event code.
        public SampleWebAuthenticationSuccessAuditEvent(
            string msg, object eventSource, 
            int eventCode, string userName):
        base(msg, eventSource, eventCode, userName)
        {
            // Perform custom initialization.
            customCreatedMsg =
                string.Format("Event created at: {0}",
                DateTime.Now.TimeOfDay.ToString());
        }

        // Invoked in case of events identified by their event code.and 
        // event detailed code.
        public SampleWebAuthenticationSuccessAuditEvent(
            string msg, object eventSource,
            int eventCode, int detailedCode, string userName):
        base(msg, eventSource, eventCode, detailedCode, userName)
        {
            // Perform custom initialization.
            customCreatedMsg =
            string.Format("Event created at: {0}",
                DateTime.Now.TimeOfDay.ToString());
        }


        // Raises the SampleWebAuthenticationSuccessAuditEvent.
        public override void Raise()
        {
            // Perform custom processing.
            customRaisedMsg =
                string.Format("Event raised at: {0}", 
                DateTime.Now.TimeOfDay.ToString());

            // Raise the event.
            WebBaseEvent.Raise(this);
        }

        // Obtains the current thread information.
        public WebRequestInformation GetRequestInformation()
        {
            // No customization is allowed.
            return RequestInformation;
        }

        //Formats Web request event information.
        //This method is invoked indirectly by the provider 
        //using one of the overloaded ToString methods.
        public override void FormatCustomEventDetails(WebEventFormatter formatter)
        {
            base.FormatCustomEventDetails(formatter);

            // Add custom data.
            formatter.AppendLine("");

            formatter.IndentationLevel += 1;
            formatter.AppendLine(
                "* SampleWebAuthenticationSuccessAuditEvent Start *");
            formatter.AppendLine(string.Format("Request path: {0}",
                RequestInformation.RequestPath));
            formatter.AppendLine(string.Format("Request Url: {0}",
                RequestInformation.RequestUrl));

            // Display custom event timing.
            formatter.AppendLine(customCreatedMsg);
            formatter.AppendLine(customRaisedMsg);

            formatter.AppendLine(
                "* SampleWebAuthenticationSuccessAuditEvent End *");

            formatter.IndentationLevel -= 1;
        }
    }
}

Keterangan

ASP.NET pemantauan kesehatan memungkinkan staf produksi dan operasi untuk mengelola aplikasi Web yang disebarkan. Namespace System.Web.Management berisi jenis peristiwa kesehatan yang bertanggung jawab untuk mengemas data status kesehatan aplikasi dan jenis penyedia yang bertanggung jawab untuk memproses data ini. Ini juga berisi jenis pendukung yang membantu selama pengelolaan peristiwa kesehatan.

Daftar berikut menjelaskan fitur yang ASP.NET menaikkan peristiwa jenis WebAuthenticationSuccessAuditEvent.

Catatan

Secara default ASP.NET dikonfigurasi untuk mencatat kondisi kegagalan audit saja, karena kondisi keberhasilan pengelogan dapat sangat mengganggu sumber daya sistem. Anda selalu dapat mengonfigurasi sistem untuk mencatat kondisi keberhasilan.

  • Autentikasi Formulir. Kondisi yang berhasil diaudit. Audit keberhasilan mencakup nama pengguna yang diautentikasi. Sebaliknya, audit kegagalan tidak menyertakan nama pengguna, karena biasanya dihasilkan dari tiket yang gagal mendekripsi atau validasi. Keduanya berisi alamat IP klien. Kode audit peristiwa terkait adalah AuditFormsAuthenticationSuccess.

  • Keanggotaan. Kondisi yang berhasil diaudit. Audit keberhasilan dan kegagalan berisi nama pengguna yang dicoba. Tidak ada bentuk audit yang akan berisi kata sandi yang dicoba, karena itu akan berisiko mempertahankan kata sandi yang valid dalam log. Kode audit peristiwa terkait adalah AuditMembershipAuthenticationSuccess.

WebAuthenticationSuccessAuditEvent Saat dinaikkan, secara default memperbarui Penghitung kinerja Peristiwa Keberhasilan Autentikasi yang Diangkat. Untuk melihat penghitung kinerja ini di Pemantau Sistem (PerfMon), di jendela Tambahkan Penghitung pilih ASP.NET di daftar drop-down Objek performa , pilih penghitung kinerja Autentikasi Keberhasilan Peristiwa yang Diangkat, dan klik tombol Tambahkan . Untuk informasi selengkapnya, lihat Menggunakan Monitor Sistem (PerfMon) dengan aplikasi ASP.NET.

Catatan

Dalam kebanyakan kasus, Anda akan dapat menggunakan jenis pemantauan kesehatan ASP.NET seperti yang diterapkan, dan Anda akan mengontrol sistem pemantauan kesehatan dengan menentukan nilai di bagian healthMonitoring konfigurasi. Anda juga dapat memperoleh dari jenis pemantauan kesehatan untuk membuat peristiwa dan penyedia kustom Anda sendiri. Untuk contoh berasal dari WebBaseEvent kelas , lihat contoh yang disediakan dalam topik ini.

Konstruktor

WebAuthenticationSuccessAuditEvent(String, Object, Int32, Int32, String)

Menginisialisasi WebSuccessAuditEvent kelas menggunakan parameter yang disediakan.

WebAuthenticationSuccessAuditEvent(String, Object, Int32, String)

Menginisialisasi WebAuthenticationSuccessAuditEvent kelas menggunakan parameter yang disediakan.

Properti

EventCode

Mendapatkan nilai kode yang terkait dengan peristiwa.

(Diperoleh dari WebBaseEvent)
EventDetailCode

Mendapatkan kode detail peristiwa.

(Diperoleh dari WebBaseEvent)
EventID

Mendapatkan pengidentifikasi yang terkait dengan peristiwa.

(Diperoleh dari WebBaseEvent)
EventOccurrence

Mendapatkan penghitung yang menunjukkan berapa kali peristiwa telah terjadi.

(Diperoleh dari WebBaseEvent)
EventSequence

Mendapatkan berapa kali peristiwa telah dinaikkan oleh aplikasi.

(Diperoleh dari WebBaseEvent)
EventSource

Mendapatkan objek yang menaikkan peristiwa.

(Diperoleh dari WebBaseEvent)
EventTime

Mendapatkan waktu ketika acara dinaikkan.

(Diperoleh dari WebBaseEvent)
EventTimeUtc

Mendapatkan waktu ketika acara dinaikkan.

(Diperoleh dari WebBaseEvent)
Message

Mendapatkan pesan yang menjelaskan peristiwa.

(Diperoleh dari WebBaseEvent)
NameToAuthenticate

Mendapatkan nama pengguna yang diautentikasi.

ProcessInformation

Mendapatkan informasi tentang proses hosting aplikasi ASP.NET.

(Diperoleh dari WebManagementEvent)
RequestInformation

Dapatkan informasi yang terkait dengan permintaan Web.

(Diperoleh dari WebAuditEvent)

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FormatCustomEventDetails(WebEventFormatter)

Menyediakan pemformatan standar informasi peristiwa.

(Diperoleh dari WebBaseEvent)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
IncrementPerfCounters()

Meningkatkan Audit Peristiwa Keberhasilan Yang Diangkat penghitung kinerja.

(Diperoleh dari WebSuccessAuditEvent)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
Raise()

Memunculkan peristiwa dengan memberi tahu penyedia yang dikonfigurasi bahwa peristiwa telah terjadi.

(Diperoleh dari WebBaseEvent)
ToString()

Memformat informasi peristiwa untuk tujuan tampilan.

(Diperoleh dari WebBaseEvent)
ToString(Boolean, Boolean)

Memformat informasi peristiwa untuk tujuan tampilan.

(Diperoleh dari WebBaseEvent)

Berlaku untuk

Produk Versi
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Lihat juga