WebSuccessAuditEvent Třída

Definice

Obor názvů:

System.Web.Management

Sestavení:

System.Web.dll

Poskytuje informace o úspěšných událostech zabezpečení.

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

public class WebSuccessAuditEvent : System.Web.Management.WebAuditEvent

type WebSuccessAuditEvent = class
    inherit WebAuditEvent

Public Class WebSuccessAuditEvent
Inherits WebAuditEvent

Dědičnost

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebSuccessAuditEvent

Odvozené

System.Web.Management.WebAuthenticationSuccessAuditEvent

Příklady

Následující příklad kódu ukazuje, jak odvodit z WebSuccessAuditEvent třídy a vytvořit vlastní událost auditu.

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

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

        // Invoked in case of events identified only by their event code.
        public SampleWebSuccessAuditEvent(string msg, 
            object eventSource, int eventCode)
            :
        base(msg, eventSource, eventCode)
        {
            // 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 SampleWebSuccessAuditEvent(string msg, object eventSource,
            int eventCode, int detailedCode)
            :
        base(msg, eventSource, eventCode, detailedCode)
        {
            // Perform custom initialization.
            customCreatedMsg =
            string.Format("Event created at: {0}",
                DateTime.Now.TimeOfDay.ToString());
        }


        // Raises the SampleWebSuccessAuditEvent.
        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 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(
                "******** SampleWebSuccessAuditEvent 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(
                "******** SampleWebSuccessAuditEvent End ********");

            formatter.IndentationLevel -= 1;
        }
    }
}

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


' Implements a custom WebSuccessAuditEvent class. 

Public Class SampleWebSuccessAuditEvent
    Inherits System.Web.Management.WebSuccessAuditEvent
    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)
        MyBase.New(msg, eventSource, eventCode)
        ' 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)
        MyBase.New(msg, EventSource, eventCode, detailedCode)
        ' Perform custom initialization.
        customCreatedMsg = String.Format("Event created at: {0}", _
        DateTime.Now.TimeOfDay.ToString())

    End Sub
    
    
    
    ' Raises the SampleWebSuccessAuditEvent.
    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 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("**SampleWebSuccessAuditEvent 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("** SampleWebSuccessAuditEvent End **")

        formatter.IndentationLevel -= 1

    End Sub
End Class

Následující příklad je výňatek konfiguračního souboru, který umožňuje ASP.NET monitorování stavu použít událost.

<healthMonitoring   
..enabled="true"  
..heartBeatInterval="0">   
  <providers>  
    <add name="EventLogProvider"   
    type="System.Web.Management.EventLogWebEventProvider,  
    System.Web,Version=2.0.3600.0,Culture=neutral,  
    PublicKeyToken=b03f5f7f11d50a3a"/>  
  </providers>  
  <eventMappings>  
    <add  name="SampleWebSuccessAuditEvent"   
      type="SamplesAspNet.SampleWebSuccessAuditEvent,  
      websuccessauditevent,Version=1.0.1663.31140,   
      Culture=neutral,   
      PublicKeyToken=0d1fa0f69d94de96,   
      processorArchitecture=MSIL"/>  
  </eventMappings>  
  <rules>  
    <add name="Custom Failure Audit Default"  
      eventName=" SampleWebFailureAuditEvent "  
      provider="EventLogProvider"  
      profile="Default"/>    
  </rules>  
</healthMonitoring>  

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.

Třída se WebSuccessAuditEvent používá, když dojde k úspěšné operaci související se zabezpečením. Příkladem je úspěšná autorizace adresy URL pro webový požadavek.

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

• Autorizace souborů. Úspěšné podmínky jsou auditovány. O autorizaci souborů se ASP.NET pokusí pouze v případech, kdy je k žádosti přidružena identita Systému Windows. Související kód auditování událostí je AuditFileAuthorizationSuccess.

• Autorizace adresy URL. Označuje přístup k prostředku adresy URL, pro který je udělena autorizace. Úspěšné podmínky jsou auditovány. Související kód auditování událostí je AuditUrlAuthorizationSuccess.

• Další bezpečnostní podmínky. Následuje seznam souvisejících kódů událostí:

  • AuditFormsAuthenticationSuccess

  • AuditMembershipAuthenticationSuccess

WebSuccessAuditEvent Když je vyvolána hodnota, ASP.NET monitorování stavu zvýší související čítač výkonu událostí úspěšného auditu a pak zkontroluje healthMonitoring konfiguraci, aby se zjistilo, jestli se k události přihlašuje některý z poskytovatelů. Pokud se poskytovatelé přihlásí k odběru události, odešle jim ASP.NET událost ke zpracování.

Poznámka

Pokud chcete zobrazit čítač výkonu Vyvolaný událostí úspěšného auditu v nástroji Sledování systému (PerfMon), v okně Přidat čítače vyberte ASP.NET z rozevíracího seznamu Objekt výkonu , vyberte čítač výkonu Vyvolaný událostí úspěchu auditu a klikněte na tlačítko Přidat . Další informace najdete v tématu Monitorování výkonu ASP.NET aplikací.

Vzhledem k tomu, že audity úspěšnosti představují očekávanou podmínku, nemusíte se k jejich odběru přihlásit. Můžete se přihlásit k jejich odběru, abyste pro web mohli poskytovat auditování přístupu.

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 WebSuccessAuditEvent třídy najdete v příkladu uvedeném v tomto tématu.

Konstruktory

WebSuccessAuditEvent(String, Object, Int32, Int32)	Inicializuje novou instanci WebSuccessAuditEvent třídy pomocí zadaných parametrů.
WebSuccessAuditEvent(String, Object, Int32)	Inicializuje novou instanci WebSuccessAuditEvent třídy 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)
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.
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é

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