WebAuditEvent Classe

Definição

public ref class WebAuditEvent : System::Web::Management::WebManagementEvent

public class WebAuditEvent : System.Web.Management.WebManagementEvent

type WebAuditEvent = class
    inherit WebManagementEvent

Public Class WebAuditEvent
Inherits WebManagementEvent

Herança

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

Derivado

System.Web.Management.WebFailureAuditEvent

System.Web.Management.WebSuccessAuditEvent

Exemplos

O exemplo de código seguinte mostra como derivar a partir da WebAuditEvent classe para criar um evento de auditoria 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

Segue-se um excerto do ficheiro de configuração que permite ao ASP.NET usar o 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>

Observações

A monitorização do estado do ASP.NET permite que as equipas de produção e operações gerenciem aplicações Web implementadas. O System.Web.Management namespace contém os tipos de eventos de saúde responsáveis por empacotar os dados de estado de saúde da aplicação e os tipos de fornecedores responsáveis pelo processamento desses dados. Inclui também tipos de apoio que ajudam na gestão de eventos de saúde.

A classe WebAuditEvent é a classe base da qual derivam as classes ASP.NET de eventos de auditoria de monitorização da saúde. Os eventos de auditoria geram informações sobre operações relacionadas com a segurança numa aplicação Web e fornecem tanto um evento de sucesso como de falha para cada operação auditada.

O sistema de monitorização de saúde pode auditar tanto eventos bem-sucedidos como não bem-sucedidos, o que significa que uma aplicação pode ser monitorizada tanto para condições normais como para mau funcionamento. Por defeito, apenas os eventos de auditoria de falha são registados.

As seguintes operações são auditadas pelo ASP.NET e podem gerar eventos de auditoria de monitorização da saúde com sucesso ou fracasso:

• Tentativas de login feitas por utilizadores de uma aplicação ASP.NET. Para mais detalhes sobre esta auditoria, consulte WebAuthenticationSuccessAuditEvent e WebSuccessAuditEvent.

• Eventos relacionados com a segurança, como falhas de autenticação, tentativas falhadas de acesso a recursos e outros eventos relacionados com a segurança. O registo destes eventos pode ser útil ao investigar uma intrusão ou ataque à aplicação. Por defeito, não é fornecido suporte de auditoria para falhas de autorização de utilizadores anónimos. Para mais detalhes sobre auditorias de eventos de falha, consulte WebAuthenticationFailureAuditEvent e WebFailureAuditEvent.

• Eventos personalizados gerados por uma aplicação ASP.NET. Pode auditar eventos personalizados estendendo a funcionalidade fornecida pela WebAuditEvent classe e pelas classes derivadas

Notas para Herdeiros

Ao formatar a informação do seu evento personalizado para exibição, sobrepor o FormatCustomEventDetails(WebEventFormatter) método em vez do ToString método. Isto evitará sobrescrever ou manipular informações sensíveis do sistema.

Ver também

• WebManagementEvent
• WebFailureAuditEvent
• WebAuthenticationFailureAuditEvent
• WebSuccessAuditEvent
• WebAuthenticationSuccessAuditEvent
• WebViewStateFailureAuditEvent
• WebEventCodes
• ASP.NET Visão Geral da Monitorização da Saúde