Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

WebAuthenticationFailureAuditEvent (Clase)

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

Espacio de nombres:  System.Web.Management
Ensamblado:  System.Web (en System.Web.dll)

public class WebAuthenticationFailureAuditEvent : WebFailureAuditEvent

El tipo WebAuthenticationFailureAuditEvent expone los siguientes miembros.

  NombreDescripción
Método protegidoWebAuthenticationFailureAuditEvent(String, Object, Int32, String)Infraestructura. Inicializa una nueva instancia de la clase WebAuthenticationFailureAuditEvent con los parámetros de evento especificados.
Método protegidoWebAuthenticationFailureAuditEvent(String, Object, Int32, Int32, String)Infraestructura. Inicializa una nueva instancia de la clase WebAuthenticationFailureAuditEvent con los parámetros de evento especificados.
Arriba

  NombreDescripción
Propiedad públicaEventCodeObtiene el valor de código asociado al evento. (Se hereda de WebBaseEvent).
Propiedad públicaEventDetailCodeObtiene el código de detalle de evento. (Se hereda de WebBaseEvent).
Propiedad públicaEventIDObtiene el identificador asociado al evento. (Se hereda de WebBaseEvent).
Propiedad públicaEventOccurrenceObtiene un contador que representa el número de veces que se ha producido el evento. (Se hereda de WebBaseEvent).
Propiedad públicaEventSequenceObtiene el número de veces que la aplicación ha provocado el evento. (Se hereda de WebBaseEvent).
Propiedad públicaEventSourceObtiene el objeto que provoca el evento. (Se hereda de WebBaseEvent).
Propiedad públicaEventTimeObtiene la hora a la que se produjo el evento. (Se hereda de WebBaseEvent).
Propiedad públicaEventTimeUtcObtiene la hora a la que se produjo el evento. (Se hereda de WebBaseEvent).
Propiedad públicaMessageObtiene el mensaje que describe el evento. (Se hereda de WebBaseEvent).
Propiedad públicaNameToAuthenticateObtiene el nombre del usuario que se va a autenticar.
Propiedad públicaProcessInformationObtiene información sobre el proceso de hospedaje de aplicaciones ASP.NET. (Se hereda de WebManagementEvent).
Propiedad públicaRequestInformationObtiene la información asociada a la solicitud Web. (Se hereda de WebAuditEvent).
Arriba

  NombreDescripción
Método públicoEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoFormatCustomEventDetailsDa un formato estándar a la información de eventos. (Se hereda de WebBaseEvent).
Método públicoGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoIncrementPerfCountersInfraestructura. Incrementa el contador de rendimiento Eventos de resultados negativos de auditoría provocados. (Se hereda de WebFailureAuditEvent).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoRaise()Provoca un evento mediante la notificación a cualquier proveedor configurado de que el evento se ha producido. (Se hereda de WebBaseEvent).
Método públicoToString()Aplica formato a información de evento para su presentación. (Se hereda de WebBaseEvent).
Método públicoToString(Boolean, Boolean)Aplica formato a información de evento para su presentación. (Se hereda de WebBaseEvent).
Arriba

La lista siguiente describe las características para las que ASP.NET genera de manera predeterminada eventos WebAuthenticationFailureAuditEvent.

NotaNota

De manera predeterminada, ASP.NET se configura para registrar solamente las condiciones de error de auditoría, ya que registrar las situaciones en las que se realiza correctamente consumiría demasiados recursos del sistema. Cuando lo desee, puede configurar el sistema para registrar las condiciones en las que no se producen errores.

  • Autenticación de formularios. Las auditorías correctas incluyen el nombre de usuario que se ha autenticado; mientras que las auditorías de resultados negativos no incluyen el nombre de usuario, puesto que normalmente las provoca un ticket que no se ha podido descifrar o validar. Ambas contienen la dirección IP del cliente. El código de auditoría de eventos relacionado es AuditFormsAuthenticationFailure.

  • Pertenencia. Las auditorías correctas e incorrectas contienen el nombre de usuario que se intentó utilizar. Ninguna forma de auditoría contendrá la contraseña que se intentó utilizar, porque supondría un riesgo para el almacenamiento de contraseñas válidas en el registro. El código de auditoría de eventos relacionado es AuditMembershipAuthenticationFailure.

Cuando se produce un evento WebAuthenticationFailureAuditEvent, el contador de rendimiento Eventos de errores de autenticación provocados se actualiza de manera predeterminada. Para ver este contador de rendimiento en Monitor de Sistema (PerfMon), en la ventana Agregar contadores, seleccione ASP.NET en la lista desplegable Rendimiento, seleccione el contador de rendimiento Eventos de errores de autenticación provocados y haga clic en el botón Agregar. Para obtener más información, vea Using the System Monitor (PerfMon) with ASP.NET Applications en MSDN.

NotaNota

En la mayoría de los casos, se podrán utilizar los tipos de supervisión de estado de ASP.NET tal como están implementados y se controlará el sistema de supervisión de estado especificando valores en la sección de configuración de healthMonitoring. Asimismo, se pueden crear proveedores y eventos personalizados a partir de los tipos de supervisión de estado. Para obtener un ejemplo de cómo se deriva de la clase WebAuthenticationFailureAuditEvent, vea el ejemplo incluido en este tema.

En el siguiente ejemplo de código, se muestra cómo utilizar 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;

        }
    }

}


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft