Compartir a través de


WebAuthenticationFailureAuditEvent Clase

Definición

Proporciona información sobre los errores de autenticación en ASP.NET.

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
Herencia

Ejemplos

En el ejemplo de código siguiente se muestra cómo se utiliza la clase WebAuthenticationFailureAuditEvent.


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

Comentarios

En la lista siguiente se describen las características para las que WebAuthenticationFailureAuditEvent se generan los eventos de forma predeterminada ASP.NET.

Nota

De forma predeterminada, ASP.NET solo está configurado para registrar condiciones de error de auditoría, ya que las condiciones de éxito del registro pueden agotar gravemente los recursos del sistema. Siempre puede configurar el sistema para registrar las condiciones de éxito.

  • Autenticación de formularios. Aunque las auditorías de éxito incluyen el nombre de usuario que se ha autenticado; Las auditorías de error no incluyen el nombre de usuario, ya que normalmente resultan de un vale que produjo un error de descifrado o validación. Ambos contienen la dirección IP del cliente. El código de auditoría de eventos relacionado es AuditFormsAuthenticationFailure.

  • Membresía. Las auditorías de éxito y error contienen el nombre de usuario que se intentó. Ninguna de las formas de auditoría contendrá la contraseña que se intentó, ya que podría arriesgarse a conservar una contraseña válida en el registro. El código de auditoría de eventos relacionado es AuditMembershipAuthenticationFailure.

Cuando se genera un WebAuthenticationFailureAuditEvent , de forma predeterminada actualiza el contador de rendimiento Audit Authentication Failure Events Raised. Para ver este contador de rendimiento en el Monitor de sistema (PerfMon), en la ventana Agregar contadores , seleccione ASP.NET en la lista desplegable Objeto de rendimiento, seleccione el contador de rendimiento Eventos de error de autenticación Generados y haga clic en el botón Agregar . Para obtener más información, vea Uso del Monitor del sistema (PerfMon) con ASP.NET Aplicaciones.

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 WebAuthenticationFailureAuditEvent clase , vea el ejemplo proporcionado en este tema.

Constructores

WebAuthenticationFailureAuditEvent(String, Object, Int32, Int32, String)

Inicializa una nueva instancia de la clase WebAuthenticationFailureAuditEvent con los parámetros de evento especificados.

WebAuthenticationFailureAuditEvent(String, Object, Int32, String)

Inicializa una nueva instancia de la clase WebAuthenticationFailureAuditEvent con los parámetros de evento especificados.

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

Obtiene el nombre del usuario que se va a autenticar.

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.

(Heredado de WebFailureAuditEvent)
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

Consulte también