WebFailureAuditEvent Clase

Referencia

Definición

Espacio de nombres:: System.Web.Management

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona información sobre los errores de seguridad.

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

Herencia: Object

WebBaseEvent

WebManagementEvent

WebAuditEvent
WebFailureAuditEvent

Derivado: System.Web.Management.WebAuthenticationFailureAuditEvent

System.Web.Management.WebViewStateFailureAuditEvent

Ejemplos

En el ejemplo de código siguiente se muestra cómo derivar de la WebFailureAuditEvent clase para crear un evento de auditoría personalizado.


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

En el extracto de configuración siguiente se muestra cómo habilitar ASP.NET para usar el WebFailureAuditEvent evento .

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

Comentarios

ASP.NET supervisión de estado permite al personal de producción y operaciones administrar las aplicaciones web implementadas. El System.Web.Management espacio de nombres contiene los tipos de eventos de mantenimiento responsables de empaquetar los datos de estado de mantenimiento de la aplicación y los tipos de proveedor responsables de procesar estos datos. También contiene tipos auxiliares que ayudan durante la administración de eventos de mantenimiento.

La WebFailureAuditEvent clase se usa cuando se produce un error en una operación de seguridad. Un ejemplo de esto es una autorización de dirección URL con error para una solicitud web.

De forma predeterminada, ASP.NET está configurado para generar el WebFailureAuditEvent evento para las siguientes características:

Autorización de archivos. ASP.NET intenta la autorización de archivos solo cuando una identidad de Windows está asociada a la solicitud. El código de auditoría de eventos relacionado es AuditFileAuthorizationFailure.
Autorización de dirección URL. Esto rige los intentos no autorizados de acceder a un recurso de dirección URL. Los intentos erróneos por parte de un usuario anónimo no se auditan, ya que el error de autenticación anónima es aceptable en la mayoría de las circunstancias. El código de auditoría de eventos relacionado es AuditUrlAuthorizationFailure.
Condiciones genéricas no controladas o no controladas de seguridad. A continuación se muestra una lista de los códigos de evento relacionados con estas condiciones:

Cuando se genera un WebFailureAuditEvent evento, ASP.NET supervisión de estado incrementa el contador de rendimiento eventos de error de auditoría relacionados y, a continuación, comprueba la healthMonitoring sección de configuración para determinar si algún proveedor se suscribe al evento. Si los proveedores se suscriben al evento, ASP.NET envía el evento a ellos para su procesamiento.

Nota

Para ver el contador de rendimiento Eventos de error de auditoría generados en el Monitor del sistema (PerfMon), en la ventana Agregar contadores , seleccione ASP.NET en la lista desplegable Objeto de rendimiento, seleccione el contador Audit Failure Events Raised performance (Audit Failure Events Raised performance counter) y haga clic en el botón Agregar .

Nota

En la mayoría de los casos, podrá usar los tipos de supervisión de estado ASP.NET tal como se implementa, y controlará el sistema de supervisión de estado especificando valores en la healthMonitoring sección de configuración. También puede derivar de los tipos de supervisión de estado para crear sus propios eventos y proveedores personalizados. Para obtener un ejemplo de derivación de la WebFailureAuditEvent clase , vea la sección Ejemplo.

Notas a los desarrolladores de herederos

Al dar formato a la información de eventos personalizada para su presentación, invalide el FormatCustomEventDetails(WebEventFormatter) método en lugar del ToString método . Esto evitará sobrescribir o alterar la información confidencial del sistema.

Constructores

WebFailureAuditEvent(String, Object, Int32, Int32)	Inicializa una nueva instancia de la clase WebFailureAuditEvent mediante los parámetros proporcionados.
WebFailureAuditEvent(String, Object, Int32)	Inicializa una nueva instancia de la clase WebFailureAuditEvent mediante los parámetros proporcionados.

Propiedades

EventCode	Obtiene el valor de código asociado al evento. (Heredado de WebBaseEvent)
EventDetailCode	Obtiene el código de detalle de evento. (Heredado de WebBaseEvent)
EventID	Obtiene el identificador asociado al evento. (Heredado de WebBaseEvent)
EventOccurrence	Obtiene un contador que representa el número de veces que se ha producido el evento. (Heredado de WebBaseEvent)
EventSequence	Obtiene el número de veces que la aplicación ha provocado el evento. (Heredado de WebBaseEvent)
EventSource	Obtiene el objeto que provoca el evento. (Heredado de WebBaseEvent)
EventTime	Obtiene la hora a la que se produjo el evento. (Heredado de WebBaseEvent)
EventTimeUtc	Obtiene la hora a la que se produjo el evento. (Heredado de WebBaseEvent)
Message	Obtiene el mensaje que describe el evento. (Heredado de WebBaseEvent)
ProcessInformation	Obtiene información sobre el proceso de hospedaje de aplicaciones ASP.NET. (Heredado de WebManagementEvent)
RequestInformation	Obtiene la información asociada a la solicitud Web. (Heredado de WebAuditEvent)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FormatCustomEventDetails(WebEventFormatter)	Da un formato estándar a la información de eventos. (Heredado de WebBaseEvent)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IncrementPerfCounters()	Incrementa el contador de rendimiento Eventos de resultados negativos de auditoría provocados.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Raise()	Provoca un evento mediante la notificación a cualquier proveedor configurado de que el evento se ha producido. (Heredado de WebBaseEvent)
ToString()	Aplica formato a información de evento para su presentación. (Heredado de WebBaseEvent)
ToString(Boolean, Boolean)	Aplica formato a información de evento para su presentación. (Heredado de WebBaseEvent)

Se aplica a

Compartir a través de