WebAuditEvent Clase
Definición
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í.
Actúa como clase base para todos los eventos de auditoría de supervisión del estado de ASP.NET.
public ref class WebAuditEvent : System::Web::Management::WebManagementEventpublic class WebAuditEvent : System.Web.Management.WebManagementEventtype WebAuditEvent = class
inherit WebManagementEventPublic Class WebAuditEvent
Inherits WebManagementEvent- Herencia
- Derivado
Ejemplos
En el ejemplo de código siguiente se muestra cómo derivar de la WebAuditEvent 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 WebAuditEvent class.
public class SampleWebAuditEvent : System.Web.Management.WebAuditEvent
{
private string customCreatedMsg, customRaisedMsg;
// Invoked in case of events identified only by their event code.
public SampleWebAuditEvent(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 SampleWebAuditEvent(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 SampleWebAuditEvent.
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()
{
// Obtain the Web request information.
// No customization is allowed here.
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(
"******** SampleWebAuditEvent Information 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(
"******** SampleWebAuditEvent Information End ********");
formatter.IndentationLevel -= 1;
}
}
}
Imports System.Text
Imports System.Web
Imports System.Web.Management
' Implements a custom WebAuditEvent class.
Public Class SampleWebAuditEvent
Inherits System.Web.Management.WebAuditEvent
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 SampleWebAuditEvent.
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
' Obtain the Web request information.
' No customization is allowed here.
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("******** SampleWebAuditEvent Information 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("******** SampleWebAuditEvent Information End ********")
formatter.IndentationLevel -= 1
End Sub
End Class
A continuación se muestra un extracto del archivo de configuración que permite que ASP.NET use el 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="SampleWebAuditEvent"
type="SamplesAspNet.SampleWebAuditEvent,
webauditevent,Version=1.0.1663.31140,
Culture=neutral,
PublicKeyToken=0d1fa0f69d94de96,
processorArchitecture=MSIL"/>
</eventMappings>
<rules>
<add name="Custom Audit Default"
eventName="SampleWebAuditEvent"
provider="EventLogProvider"
profile="Default"/>
</rules>
</healthMonitoring>
Comentarios
ASP.NET supervisión de 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 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 WebAuditEvent clase es la clase base de la que derivan las clases audit-event de ASP.NET de supervisión de estado. Los eventos de auditoría generan información sobre las operaciones relacionadas con la seguridad en una aplicación web y proporcionan un evento de éxito y error para cada operación auditada.
El sistema de supervisión de estado puede auditar eventos correctos e incorrectos, lo que significa que se puede supervisar una aplicación tanto para condiciones normales como de mal funcionamiento. De forma predeterminada, solo se registran los eventos de auditoría de error.
Las siguientes operaciones se auditan mediante ASP.NET y pueden generar eventos de auditoría de supervisión de estado correctos o erróneos:
Intentos de inicio de sesión realizados por los usuarios de una aplicación de ASP.NET. Para obtener más información sobre esta auditoría, vea WebAuthenticationSuccessAuditEvent y WebSuccessAuditEvent.
Eventos relacionados con la seguridad, como errores de autenticación, intentos de acceso a recursos erróneos y otros eventos relacionados con la seguridad. El registro de estos eventos puede ser útil al investigar una intrusión o un ataque en la aplicación. De forma predeterminada, no se proporciona compatibilidad con auditorías para errores de autorización de usuarios anónimos. Para más información sobre las auditorías de eventos de error, consulte WebAuthenticationFailureAuditEvent y WebFailureAuditEvent.
Eventos personalizados generados por una aplicación de ASP.NET. Puede auditar eventos personalizados si amplía la funcionalidad proporcionada por la WebAuditEvent clase y las clases derivadas.
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 WebAuditEvent clase , vea el ejemplo proporcionado en este tema.
Notas a los desarrolladores de herederos
Al dar formato a la información de eventos personalizada para mostrar, invalide el FormatCustomEventDetails(WebEventFormatter) método en lugar del ToString método . Esto evitará sobrescribir o alterar la información confidencial del sistema.
Constructores
| WebAuditEvent(String, Object, Int32) |
Inicializa una nueva instancia de la clase WebAuditEvent mediante los parámetros proporcionados. |
| WebAuditEvent(String, Object, Int32, Int32) |
Inicializa una nueva instancia de la clase WebAuditEvent 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) |
| 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. |
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() |
Se utiliza internamente para incrementar los contadores de rendimiento. (Heredado de WebBaseEvent) |
| 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) |