WebAuthenticationFailureAuditEvent Klasse

Referenz

Definition

Namespace:: System.Web.Management

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt Informationen über ASP.NET-Authentifizierungsfehler bereit.

public ref class WebAuthenticationFailureAuditEvent : System::Web::Management::WebFailureAuditEvent

public class WebAuthenticationFailureAuditEvent : System.Web.Management.WebFailureAuditEvent

type WebAuthenticationFailureAuditEvent = class
    inherit WebFailureAuditEvent

Public Class WebAuthenticationFailureAuditEvent
Inherits WebFailureAuditEvent

Vererbung: Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebFailureAuditEvent
WebAuthenticationFailureAuditEvent

Beispiele

Im folgenden Codebeispiel wird die Verwendung der WebAuthenticationFailureAuditEvent-Klasse veranschaulicht.


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

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

        // Invoked in case of events identified only by 
        // their event code.
        public SampleWebAuthenticationFailureAuditEvent(
            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 SampleWebAuthenticationFailureAuditEvent(
            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 SampleWebAuthenticationFailureAuditEvent.
        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(
                "* SampleWebAuthenticationFailureAuditEvent 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(
                "* SampleWebAuthenticationFailureAuditEvent End *");

            formatter.IndentationLevel -= 1;
        }
    }
}

Imports System.Text
Imports System.Web
Imports System.Web.Management


' Implements a custom WebAuthenticationFailureAuditEvent class. 

Public Class SampleWebAuthenticationFailureAuditEvent
    Inherits System.Web.Management.WebAuthenticationFailureAuditEvent
    Private customCreatedMsg, customRaisedMsg As String



    ' Invoked in case of events identified only by their event code.
    Public Sub New(ByVal msg As String, ByVal eventSource _
    As Object, ByVal eventCode As Integer, _
    ByVal userName As String)
        MyBase.New(msg, eventSource, eventCode, userName)
        ' Perform custom initialization.
        customCreatedMsg = _
        String.Format("Event created at: {0}", _
        DateTime.Now.TimeOfDay.ToString())

    End Sub


    ' Invoked in case of events identified by their event code.and 
    ' event detailed code.
    Public Sub New(ByVal msg As String, ByVal eventSource As Object, _
    ByVal eventCode As Integer, ByVal detailedCode As Integer, _
    ByVal userName As String)
        MyBase.New(msg, eventSource, eventCode, _
        detailedCode, userName)
        ' Perform custom initialization.
        customCreatedMsg = _
        String.Format( _
        "Event created at: {0}", DateTime.Now.TimeOfDay.ToString())

    End Sub



    ' Raises the SampleWebAuthenticationFailureAuditEvent.
    Public Overrides Sub Raise()
        ' Perform custom processing.
        customRaisedMsg = String.Format( _
        "Event raised at: {0}", _
        DateTime.Now.TimeOfDay.ToString())

        ' Raise the event.
        WebBaseEvent.Raise(Me)

    End Sub


    ' Obtains the current thread information.
    Public Function GetRequestInformation() _
    As WebRequestInformation
        ' No customization is allowed.
        Return RequestInformation

    End Function 'GetRequestInformation


    'Formats Web request event information.
    'This method is invoked indirectly by the provider 
    'using one of the overloaded ToString methods.
    Public Overrides Sub FormatCustomEventDetails(ByVal formatter _
    As WebEventFormatter)
        MyBase.FormatCustomEventDetails(formatter)

        ' Add custom data.
        formatter.AppendLine("")

        formatter.IndentationLevel += 1
        formatter.AppendLine( _
        "* SampleWebAuthenticationFailureAuditEvent 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( _
        "* SampleWebAuthenticationFailureAuditEvent End *")

        formatter.IndentationLevel -= 1

    End Sub
End Class

Hinweise

In der folgenden Liste werden die Features beschrieben, für die WebAuthenticationFailureAuditEvent Ereignisse standardmäßig von ASP.NET ausgelöst werden.

Hinweis

Standardmäßig ist ASP.NET so konfiguriert, dass nur Überwachungsfehlerbedingungen protokolliert werden, da die Protokollierung von Erfolgsbedingungen die Systemressourcen stark belasten kann. Sie können das System jederzeit so konfigurieren, dass die Erfolgsbedingungen protokolliert werden.

Formularauthentifizierung. Erfolgsüberwachungen enthalten den Benutzernamen, der authentifiziert wurde; Fehlerüberwachungen enthalten den Benutzernamen nicht, da sie sich in der Regel auf ein Ticket beziehen, bei dem die Entschlüsselung oder Validierung fehlgeschlagen ist. Beide enthalten die Client-IP-Adresse. Der zugehörige Ereignisüberwachungscode ist AuditFormsAuthenticationFailure.
Mitgliedschaft. Sowohl Erfolgs- als auch Fehlerüberwachungen enthalten den Benutzernamen, der versucht wurde. Keine der Formen der Überwachung enthält das Kennwort, das versucht wurde, da dadurch die Gefahr besteht, dass ein gültiges Kennwort im Protokoll beibehalten wird. Der zugehörige Ereignisüberwachungscode ist AuditMembershipAuthenticationFailure.

Wenn ein WebAuthenticationFailureAuditEvent ausgelöst wird, wird standardmäßig der Leistungsindikator Überwachungsauthentifizierungsfehlerereignisse ausgelöst aktualisiert. Um diesen Leistungsindikator im Systemmonitor (PerfMon) anzuzeigen, wählen Sie ASP.NET im Fenster Leistungsindikatoren hinzufügen in der Dropdownliste Leistungsobjekt den Leistungsindikator Authentifizierungsfehler ausgelöst aus, und klicken Sie auf die Schaltfläche Hinzufügen. Weitere Informationen finden Sie unter Verwenden des Systemmonitors (PerfMon) mit ASP.NET Anwendungen.

Hinweis

In den meisten Fällen können Sie die ASP.NET Typen der Integritätsüberwachung wie implementiert verwenden, und Sie steuern das System zur Integritätsüberwachung, indem Sie Werte im healthMonitoring Konfigurationsabschnitt angeben. Sie können auch von den Integritätsüberwachungstypen ableiten, um eigene benutzerdefinierte Ereignisse und Anbieter zu erstellen. Ein Beispiel für die Ableitung von der WebAuthenticationFailureAuditEvent -Klasse finden Sie im Beispiel in diesem Thema.

Konstruktoren

WebAuthenticationFailureAuditEvent(String, Object, Int32, Int32, String)	Initialisiert eine neue Instanz der WebAuthenticationFailureAuditEvent-Klasse mit den angegebenen Ereignisparametern.
WebAuthenticationFailureAuditEvent(String, Object, Int32, String)	Initialisiert eine neue Instanz der WebAuthenticationFailureAuditEvent-Klasse mit den angegebenen Ereignisparametern.

Eigenschaften

EventCode	Ruft den Codewert ab, der dem Ereignis zugeordnet ist. (Geerbt von WebBaseEvent)
EventDetailCode	Ruft den Ereignisdetailcode ab. (Geerbt von WebBaseEvent)
EventID	Ruft den dem Ereignis zugeordneten Bezeichner ab. (Geerbt von WebBaseEvent)
EventOccurrence	Ruft einen Zähler ab, der die Häufigkeit darstellt, mit der das Ereignis eingetreten ist. (Geerbt von WebBaseEvent)
EventSequence	Ruft die Häufigkeit ab, mit der das Ereignis von der Anwendung ausgelöst wurde. (Geerbt von WebBaseEvent)
EventSource	Ruft das Objekt ab, das das Ereignis auslöst. (Geerbt von WebBaseEvent)
EventTime	Ruft die Uhrzeit ab, zu der das Ereignis ausgelöst wurde. (Geerbt von WebBaseEvent)
EventTimeUtc	Ruft die Uhrzeit ab, zu der das Ereignis ausgelöst wurde. (Geerbt von WebBaseEvent)
Message	Ruft die Meldung ab, in der das Ereignis beschrieben wird. (Geerbt von WebBaseEvent)
NameToAuthenticate	Ruft den Namen des zu authentifizierenden Benutzers ab.
ProcessInformation	Ruft Informationen über den Hostprozess der ASP.NET-Anwendung ab. (Geerbt von WebManagementEvent)
RequestInformation	Ruft die der Webanforderung zugeordneten Informationen ab. (Geerbt von WebAuditEvent)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FormatCustomEventDetails(WebEventFormatter)	Stellt Standardformatierung der Ereignisinformationen bereit. (Geerbt von WebBaseEvent)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IncrementPerfCounters()	Erhöht den Leistungsindikator Bei Überwachungsfehlern ausgelöste Ereignisse. (Geerbt von WebFailureAuditEvent)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Raise()	Löst ein Ereignis aus, indem ein konfigurierter Anbieter benachrichtigt wird, dass das Ereignis eingetreten ist. (Geerbt von WebBaseEvent)
ToString()	Formatiert Ereignisinformationen für die Anzeige. (Geerbt von WebBaseEvent)
ToString(Boolean, Boolean)	Formatiert Ereignisinformationen für die Anzeige. (Geerbt von WebBaseEvent)

Gilt für: