WebFailureAuditEvent Klas

Definitie

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

public class WebFailureAuditEvent : System.Web.Management.WebAuditEvent

type WebFailureAuditEvent = class
    inherit WebAuditEvent

Public Class WebFailureAuditEvent
Inherits WebAuditEvent

Overname

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebFailureAuditEvent

Afgeleid

System.Web.Management.WebAuthenticationFailureAuditEvent

System.Web.Management.WebViewStateFailureAuditEvent

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u kunt afleiden van de WebFailureAuditEvent klasse om een aangepaste auditgebeurtenis te maken.

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

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

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

            formatter.IndentationLevel -= 1;
        }
    }
}

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


' Implements a custom WebFailureAuditEvent class. 

Public Class SampleWebFailureAuditEvent
    Inherits System.Web.Management.WebFailureAuditEvent
    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 SampleWebFailureAuditEvent.
    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("******** SampleWebFailureAuditEvent 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("******** SampleWebFailureAuditEvent End ********")

        formatter.IndentationLevel -= 1

    End Sub

End Class

In het volgende configuratiefragment ziet u hoe u ASP.NET kunt inschakelen om de gebeurtenis WebFailureAuditEvent te gebruiken.

<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="SampleWebFailureAuditEvent"
type="SamplesAspNet.SampleWebFailureAuditEvent,
webfailureauditevent,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>

Opmerkingen

ASP.NET statuscontrole maakt het productie- en operationele personeel mogelijk om geïmplementeerde webtoepassingen te beheren. De System.Web.Management naamruimte bevat de statusgebeurtenistypen die verantwoordelijk zijn voor het verpakken van statusgegevens van toepassingen en de providertypen die verantwoordelijk zijn voor het verwerken van deze gegevens. Het bevat ook ondersteunende typen die u helpen tijdens het beheer van statusevenementen.

De WebFailureAuditEvent klasse wordt gebruikt wanneer een beveiligingsbewerking mislukt. Een voorbeeld hiervan is een mislukte URL-autorisatie voor een webaanvraag.

Standaard is ASP.NET geconfigureerd om de gebeurtenis WebFailureAuditEvent te verhogen voor de volgende functies:

• Bestandsautorisatie. ASP.NET probeert alleen bestandsautorisatie uit te voeren wanneer een Windows-identiteit aan de aanvraag is gekoppeld. De gerelateerde controlecode voor gebeurtenissen is AuditFileAuthorizationFailure.

• URL-autorisatie. Dit geldt voor onbevoegde pogingen om toegang te krijgen tot een URL-resource. Mislukte pogingen van een anonieme gebruiker worden niet gecontroleerd, omdat anonieme verificatiefouten in de meeste gevallen acceptabel zijn. De gerelateerde controlecode voor gebeurtenissen is AuditUrlAuthorizationFailure.

• Algemene niet-verwerkte of niet-verwerkte voorwaarden voor beveiliging. Hier volgt een lijst met de gebeurteniscodes die betrekking hebben op deze voorwaarden:

  • AuditFormsAuthenticationFailure

  • AuditMembershipAuthenticationFailure

  • AuditInvalidViewStateFailure

  • AuditUnhandledSecurityException

  • AuditUnhandledAccessException

Wanneer er een WebFailureAuditEvent gebeurtenis wordt gegenereerd, wordt de gerelateerde prestatiemeteritem voor foutgebeurtenissen verhoogd ASP.NET ASP.NET en wordt vervolgens de healthMonitoring configuratiesectie gecontroleerd om te bepalen of providers zich abonneren op de gebeurtenis. Als providers zich abonneren op de gebeurtenis, ASP.NET de gebeurtenis naar hen verzendt voor verwerking.

Notities voor overnemers

Wanneer u de aangepaste gebeurtenisgegevens voor weergave opmaakt, overschrijft u de FormatCustomEventDetails(WebEventFormatter) methode in plaats van de ToString methode. Dit voorkomt dat gevoelige systeemgegevens worden overschreven of gemanipuleerd.

Zie ook

• WebAuditEvent
• WebSuccessAuditEvent
• WebEventCodes
• Overzicht van ASP.NET statuscontrole