WebFailureAuditEvent Classe

Definição

Namespace:

System.Web.Management

Assembly:

System.Web.dll

Fornece informações sobre falhas de segurança.

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

public class WebFailureAuditEvent : System.Web.Management.WebAuditEvent

type WebFailureAuditEvent = class
    inherit WebAuditEvent

Public Class WebFailureAuditEvent
Inherits WebAuditEvent

Herança

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebFailureAuditEvent

Derivado

System.Web.Management.WebAuthenticationFailureAuditEvent

System.Web.Management.WebViewStateFailureAuditEvent

Exemplos

O exemplo de código a seguir demonstra como derivar da WebFailureAuditEvent 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 WebFailureAuditEvent class. 
    public class SampleWebFailureAuditEvent : 
        System.Web.Management.WebFailureAuditEvent
    {
        private string customCreatedMsg, customRaisedMsg;

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

            formatter.IndentationLevel -= 1;
        }
    }
}

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


' Implements a custom WebFailureAuditEvent class. 

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

        formatter.IndentationLevel -= 1

    End Sub

End Class

O trecho de configuração a seguir mostra como habilitar ASP.NET usar o WebFailureAuditEvent 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="SampleWebFailureAuditEvent"
type="SamplesAspNet.SampleWebFailureAuditEvent,
webfailureauditevent,Version=1.0.1663.31140,
Culture=neutral,
PublicKeyToken=0d1fa0f69d94de96,
processorArchitecture=MSIL"/>
</eventMappings>

<rules>
<add name="Custom Failure Audit Default"
eventName=" SampleWebFailureAuditEvent "
provider="EventLogProvider"
profile="Default"/>
</rules>

</healthMonitoring>

Comentários

ASP.NET monitoramento de integridade permite que a equipe de produção e operações gerencie aplicativos Web implantados. O System.Web.Management namespace contém os tipos de eventos de integridade responsáveis por empacotar dados status de integridade do aplicativo e os tipos de provedor responsáveis por processar esses dados. Ele também contém tipos de suporte que ajudam durante o gerenciamento de eventos de integridade.

A WebFailureAuditEvent classe é usada quando uma operação de segurança falha. Um exemplo disso é uma autorização de URL com falha para uma solicitação da Web.

Por padrão, ASP.NET é configurado para gerar o WebFailureAuditEvent evento para os seguintes recursos:

• Autorização de arquivo. ASP.NET tenta autorização de arquivo somente quando uma Identidade do Windows está associada à solicitação. O código de auditoria de evento relacionado é AuditFileAuthorizationFailure.

• Autorização de URL. Isso rege tentativas não autorizadas de acessar um recurso de URL. As tentativas com falha de um usuário anônimo não são auditadas, pois a falha de autenticação anônima é aceitável na maioria das circunstâncias. O código de auditoria de evento relacionado é AuditUrlAuthorizationFailure.

• Condições genéricas sem tratamento ou sem tratamento de segurança. Veja a seguir uma lista dos códigos de evento relacionados a estas condições:

  • AuditFormsAuthenticationFailure

  • AuditMembershipAuthenticationFailure

  • AuditInvalidViewStateFailure

  • AuditUnhandledSecurityException

  • AuditUnhandledAccessException

Quando um WebFailureAuditEvent evento é acionado, ASP.NET monitoramento de integridade incrementa o contador de desempenho eventos de falha de auditoria relacionados gerados e verifica a healthMonitoring seção de configuração para determinar se algum provedor assina o evento. Se os provedores assinarem o evento, ASP.NET enviará o evento para eles para processamento.

Observação

Para exibir o contador de desempenho Eventos de Falha de Auditoria gerados no Monitor do Sistema (PerfMon), na janela Adicionar Contadores , selecione ASP.NET na lista suspensa Objetos de desempenho , selecione o contador de desempenho Eventos de Falha de Auditoria Gerados e clique no botão Adicionar .

Observação

Na maioria dos casos, você poderá usar os tipos de monitoramento de integridade ASP.NET conforme implementado e controlará o sistema de monitoramento de integridade especificando valores na healthMonitoring seção de configuração. Você também pode derivar dos tipos de monitoramento de integridade para criar seus próprios eventos e provedores personalizados. Para obter um exemplo de derivação da WebFailureAuditEvent classe , consulte a seção Exemplo.

Notas aos Herdeiros

Ao formatar suas informações de evento personalizadas para exibição, substitua o FormatCustomEventDetails(WebEventFormatter) método em vez do ToString método . Isso evitará substituir ou adulterar informações confidenciais do sistema.

Construtores

WebFailureAuditEvent(String, Object, Int32)	Inicializa uma nova instância da classe WebFailureAuditEvent usando os parâmetros fornecidos.
WebFailureAuditEvent(String, Object, Int32, Int32)	Inicializa uma nova instância da classe WebFailureAuditEvent usando os parâmetros fornecidos.

Propriedades

EventCode	Obtém o valor de código associado ao evento. (Herdado de WebBaseEvent)
EventDetailCode	Obtém o código de detalhes do evento. (Herdado de WebBaseEvent)
EventID	Obtém o identificador associado ao evento. (Herdado de WebBaseEvent)
EventOccurrence	Obtém um contador que representa o número de vezes que o evento ocorreu. (Herdado de WebBaseEvent)
EventSequence	Obtém o número de vezes que o evento foi gerado pelo aplicativo. (Herdado de WebBaseEvent)
EventSource	Obtém o objeto que gera o evento. (Herdado de WebBaseEvent)
EventTime	Obtém a hora em que o evento foi gerado. (Herdado de WebBaseEvent)
EventTimeUtc	Obtém a hora em que o evento foi gerado. (Herdado de WebBaseEvent)
Message	Obtém a mensagem que descreve o evento. (Herdado de WebBaseEvent)
ProcessInformation	Obtém informações sobre o processo de hospedagem de aplicativos do ASP.NET. (Herdado de WebManagementEvent)
RequestInformation	Obter as informações associadas à solicitação da Web. (Herdado de WebAuditEvent)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FormatCustomEventDetails(WebEventFormatter)	Fornece a formatação padrão das informações do evento. (Herdado de WebBaseEvent)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IncrementPerfCounters()	Incrementa o contador de desempenho de eventos de falha de auditoria gerados.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Raise()	Gera um evento notificando qualquer provedor configurado de que o evento ocorreu. (Herdado de WebBaseEvent)
ToString()	Formata as informações de evento para fins de exibição. (Herdado de WebBaseEvent)
ToString(Boolean, Boolean)	Formata as informações de evento para fins de exibição. (Herdado de WebBaseEvent)

Confira também

• WebAuditEvent
• WebSuccessAuditEvent
• WebEventCodes
• Visão geral do Monitoramento de Integridade do ASP.NET