WebAuthenticationSuccessAuditEvent Clase

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 eventos de autenticación correctos.

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

public class WebAuthenticationSuccessAuditEvent : System.Web.Management.WebSuccessAuditEvent

type WebAuthenticationSuccessAuditEvent = class
    inherit WebSuccessAuditEvent

Public Class WebAuthenticationSuccessAuditEvent
Inherits WebSuccessAuditEvent

Herencia: Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebSuccessAuditEvent
WebAuthenticationSuccessAuditEvent

Ejemplos

Este ejemplo de código tiene dos partes: un fragmento de archivo de configuración, seguido de código que muestra cómo personalizar el WebAuthenticationSuccessAuditEvent evento.

A continuación se muestra un extracto de las secciones y eventMappings del provider archivo de configuración. Ya están establecidos de forma predeterminada. Lo único que debe hacer es proporcionar la configuración del rules elemento en la healthMonitoring sección.

<healthMonitoring
  enabled="true"
  heartBeatInterval="0">

    <providers>
      // Configure the provider to process
      // the health events.
      <add name="EventLogProvider"
         type="System.Web.Management.EventLogWebEventProvider,
         System.Web,Version=2.0.3600.0,Culture=neutral,
         PublicKeyToken=b03f5f7f11d50a3a"/>
    </providers>

    <eventMappings>
       <clear />
       // Configure the custom event
       // to handle the audit events.
        <add name="SampleWebAuthenticationSuccessAuditEvent"
          type="SamplesAspNet.SampleWebAuthenticationSuccessAuditEvent,
          webauthsuccessaudit, Version=1.0.1735.23144, Culture=neutral,
          PublicKeyToken=dd969eda3f3f6ae1, processorArchitecture=MSIL" />

     </eventMappings>
     <rules>
       <clear/>
       // Establish the connection between custom event
       // and the provider that must process it.
      <add name="Log Authentication Success Audits"
        eventName="SampleWebAuthenticationFailureAuditEvent"
        provider="EventLogProvider"
        profile="Custom" />\
     </rules>

</healthMonitoring>

En el código siguiente se muestra cómo personalizar el WebAuthenticationSuccessAuditEvent evento.


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

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

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

            formatter.IndentationLevel -= 1;
        }
    }
}

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


' Implements a custom WebAuthenticationSuccessAuditEvent class. 

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

        formatter.IndentationLevel -= 1

    End Sub
End Class

Comentarios

ASP.NET supervisión del estado permite al personal de producción y operaciones administrar 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 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.

En la lista siguiente se describen las características para las que ASP.NET genera eventos de tipo WebAuthenticationSuccessAuditEvent.

Note

De forma predeterminada, ASP.NET está configurado para registrar las 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. Se auditan las condiciones correctas. Las auditorías correctas incluyen el nombre de usuario autenticado. En su lugar, las auditorías de errores 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 AuditFormsAuthenticationSuccess.
Pertenencia. Se auditan las condiciones correctas. 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 AuditMembershipAuthenticationSuccess.

Cuando se genera un WebAuthenticationSuccessAuditEvent , de forma predeterminada actualiza el contador de rendimiento Eventos de éxito de autenticación generados. Para ver este contador de rendimiento en el Monitor de sistema (PerfMon), en la ventana Agregar contadores seleccione ASP.NET en el objeto Performance lista desplegable, Seleccione el contador Eventos de éxito de autenticación Desencadenado de rendimiento y haga clic en el botón Agregar. Para obtener más información, consulte Using the System Monitor (PerfMon) with ASP.NET Applications.

Note

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 sección de configuración de healthMonitoring. 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 WebBaseEvent clase , vea el ejemplo proporcionado en este tema.

Constructores

Nombre	Description
WebAuthenticationSuccessAuditEvent(String, Object, Int32, Int32, String)	Inicializa la WebSuccessAuditEvent clase mediante los parámetros proporcionados.
WebAuthenticationSuccessAuditEvent(String, Object, Int32, String)	Inicializa la WebAuthenticationSuccessAuditEvent clase mediante los parámetros proporcionados.

Propiedades

Nombre	Description
EventCode	Obtiene el valor de código asociado al evento . (Heredado de WebBaseEvent)
EventDetailCode	Obtiene el código de detalle del 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 generado el evento. (Heredado de WebBaseEvent)
EventSource	Obtiene el objeto que genera el evento. (Heredado de WebBaseEvent)
EventTime	Obtiene la hora en que se generó el evento. (Heredado de WebBaseEvent)
EventTimeUtc	Obtiene la hora en que se generó el evento. (Heredado de WebBaseEvent)
Message	Obtiene el mensaje que describe el evento. (Heredado de WebBaseEvent)
NameToAuthenticate	Obtiene el nombre del usuario autenticado.
ProcessInformation	Obtiene información sobre el proceso de hospedaje de aplicaciones de ASP.NET. (Heredado de WebManagementEvent)
RequestInformation	Obtenga la información asociada a la solicitud web. (Heredado de WebAuditEvent)

Métodos

Nombre	Description
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FormatCustomEventDetails(WebEventFormatter)	Proporciona formato estándar de la información del evento. (Heredado de WebBaseEvent)
GetHashCode()	Actúa 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 Audit Success Events Raised. (Heredado de WebSuccessAuditEvent)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Raise()	Genera un evento notificando a cualquier proveedor configurado que se haya producido el evento. (Heredado de WebBaseEvent)
ToString()	Da formato a la información de eventos con fines de presentación. (Heredado de WebBaseEvent)
ToString(Boolean, Boolean)	Da formato a la información de eventos con fines de presentación. (Heredado de WebBaseEvent)

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?