WebAuthenticationSuccessAuditEvent Třída

Definice

Obor názvů:

System.Web.Management

Sestavení:

System.Web.dll

Poskytuje informace o úspěšných událostech ověřování.

public ref class WebAuthenticationSuccessAuditEvent : System::Web::Management::WebSuccessAuditEvent

public class WebAuthenticationSuccessAuditEvent : System.Web.Management.WebSuccessAuditEvent

type WebAuthenticationSuccessAuditEvent = class
    inherit WebSuccessAuditEvent

Public Class WebAuthenticationSuccessAuditEvent
Inherits WebSuccessAuditEvent

Dědičnost

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebSuccessAuditEvent

WebAuthenticationSuccessAuditEvent

Příklady

Tento příklad kódu má dvě části: výňatek konfiguračního souboru následovaný kódem, který ukazuje, jak přizpůsobit WebAuthenticationSuccessAuditEvent událost.

Toto je výňatek z konfiguračního souboru provider a eventMappings oddílů. Ve výchozím nastavení jsou už nastavené. Jediné, co musíte udělat, je poskytnout nastavení pro rules prvek v oddílu 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>  

Následující kód ukazuje, jak přizpůsobit WebAuthenticationSuccessAuditEvent událost.

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;
        }
    }
}

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


' Implements a custom WebAuthenticationSuccessAuditEvent class. 

Public Class SampleWebAuthenticationSuccessAuditEvent
    Inherits System.Web.Management.WebAuthenticationSuccessAuditEvent
    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 SampleWebAuthenticationSuccessAuditEvent.
    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( _
        "* 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

    End Sub
End Class

Poznámky

ASP.NET monitorování stavu umožňuje provozním a provozním pracovníkům spravovat nasazené webové aplikace. Obor System.Web.Management názvů obsahuje typy událostí stavu zodpovědné za balení dat o stavu aplikace a typy zprostředkovatelů zodpovědné za zpracování těchto dat. Obsahuje také podpůrné typy, které pomáhají při správě událostí stavu.

Následující seznam popisuje funkce, pro které ASP.NET vyvolává události typu WebAuthenticationSuccessAuditEvent.

Poznámka

Ve výchozím nastavení je ASP.NET nakonfigurovaná tak, aby protokolovala pouze podmínky selhání auditu, protože podmínky úspěšného protokolování můžou výrazně zatížit systémové prostředky. Systém můžete vždy nakonfigurovat tak, aby zaznamenával podmínky úspěchu.

• Ověřování pomocí formulářů. Úspěšné podmínky jsou auditovány. Audity úspěšnosti zahrnují uživatelské jméno, které bylo ověřeno. Místo toho audity selhání neobsahují uživatelské jméno, protože jsou obvykle výsledkem lístku, který selhal při dešifrování nebo ověření. Obě obsahují IP adresu klienta. Související kód auditování událostí je AuditFormsAuthenticationSuccess.

• Členství. Úspěšné podmínky jsou auditovány. Audity úspěšnosti i selhání obsahují uživatelské jméno, které se pokusilo. Ani jedna z forem auditu nebude obsahovat heslo, o které jste se pokusili, protože by to riskovalo zachování platného hesla v protokolu. Související kód auditování událostí je AuditMembershipAuthenticationSuccess.

Při vyvolání WebAuthenticationSuccessAuditEvent se ve výchozím nastavení aktualizuje čítač výkonu událostí úspěšného ověřování. Chcete-li zobrazit tento čítač výkonu v nástroji Sledování systému (PerfMon), vyberte v okně Přidat čítačeASP.NET v rozevíracím seznamu Objekt výkonu , vyberte čítač výkonu událostí úspěšného ověřování a klikněte na tlačítko Přidat . Další informace najdete v tématu Použití nástroje Sledování systému (PerfMon) s aplikacemi ASP.NET.

Poznámka

Ve většině případů budete moct použít ASP.NET typy monitorování stavu tak, jak jsou implementovány, a systém monitorování stavu budete řídit zadáním hodnot v healthMonitoring části konfigurace. Můžete také odvodit z typů monitorování stavu a vytvořit vlastní události a zprostředkovatele. Příklad odvození z WebBaseEvent třídy najdete v příkladu uvedeném v tomto tématu.

Konstruktory

WebAuthenticationSuccessAuditEvent(String, Object, Int32, Int32, String)	Inicializuje WebSuccessAuditEvent třídu pomocí zadaných parametrů.
WebAuthenticationSuccessAuditEvent(String, Object, Int32, String)	Inicializuje WebAuthenticationSuccessAuditEvent třídu pomocí zadaných parametrů.

Vlastnosti

EventCode	Získá hodnotu kódu přidruženou k události. (Zděděno od WebBaseEvent)
EventDetailCode	Získá kód podrobností události. (Zděděno od WebBaseEvent)
EventID	Získá identifikátor přidružený k události. (Zděděno od WebBaseEvent)
EventOccurrence	Získá čítač, který představuje počet výskytů události. (Zděděno od WebBaseEvent)
EventSequence	Získá kolikrát byla vyvolána událostí aplikace. (Zděděno od WebBaseEvent)
EventSource	Získá objekt, který vyvolá událost. (Zděděno od WebBaseEvent)
EventTime	Získá čas, kdy byla událost vyvolána. (Zděděno od WebBaseEvent)
EventTimeUtc	Získá čas, kdy byla událost vyvolána. (Zděděno od WebBaseEvent)
Message	Získá zprávu, která popisuje událost. (Zděděno od WebBaseEvent)
NameToAuthenticate	Získá název ověřeného uživatele.
ProcessInformation	Získá informace o procesu hostování aplikace ASP.NET. (Zděděno od WebManagementEvent)
RequestInformation	Získejte informace přidružené k webové žádosti. (Zděděno od WebAuditEvent)

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FormatCustomEventDetails(WebEventFormatter)	Poskytuje standardní formátování informací o události. (Zděděno od WebBaseEvent)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IncrementPerfCounters()	Zvýší čítač výkonu událostí úspěšného auditu. (Zděděno od WebSuccessAuditEvent)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Raise()	Vyvolá událost oznámením libovolného nakonfigurovaného zprostředkovatele, že k události došlo. (Zděděno od WebBaseEvent)
ToString()	Formátuje informace o událostech pro účely zobrazení. (Zděděno od WebBaseEvent)
ToString(Boolean, Boolean)	Formátuje informace o událostech pro účely zobrazení. (Zděděno od WebBaseEvent)

Viz také

• WebAuthenticationFailureAuditEvent
• WebEventCodes
• Přehled monitorování stavu ASP.NET