Partilhar via


WebAuthenticationFailureAuditEvent Classe

Definição

Fornece informações sobre falhas de autenticação do ASP.NET.

public ref class WebAuthenticationFailureAuditEvent : System::Web::Management::WebFailureAuditEvent
public class WebAuthenticationFailureAuditEvent : System.Web.Management.WebFailureAuditEvent
type WebAuthenticationFailureAuditEvent = class
    inherit WebFailureAuditEvent
Public Class WebAuthenticationFailureAuditEvent
Inherits WebFailureAuditEvent
Herança

Exemplos

O exemplo de código a seguir mostra como usar a WebAuthenticationFailureAuditEvent classe .


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;
        }
    }
}
Imports System.Text
Imports System.Web
Imports System.Web.Management


' Implements a custom WebAuthenticationFailureAuditEvent class. 

Public Class SampleWebAuthenticationFailureAuditEvent
    Inherits System.Web.Management.WebAuthenticationFailureAuditEvent
    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 SampleWebAuthenticationFailureAuditEvent.
    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( _
        "* 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

    End Sub
End Class

Comentários

A lista a seguir descreve os recursos para os quais WebAuthenticationFailureAuditEvent os eventos são gerados por padrão por ASP.NET.

Observação

Por padrão, ASP.NET é configurado apenas para registrar condições de falha de auditoria, pois as condições de sucesso de registro em log podem sobrecarregar severamente os recursos do sistema. Você sempre pode configurar o sistema para registrar as condições de êxito.

  • Autenticação de Formulários. Embora as auditorias de êxito incluam o nome de usuário que foi autenticado; As auditorias de falha não incluem o nome de usuário, pois normalmente resultam de um tíquete que falhou na descriptografia ou na validação. Ambos contêm o endereço IP do cliente. O código de auditoria de evento relacionado é AuditFormsAuthenticationFailure.

  • Associação. As auditorias de êxito e falha contêm o nome de usuário que foi tentado. Nenhuma das formas de auditoria conterá a senha que foi tentada, pois isso correria o risco de persistir uma senha válida no log. O código de auditoria de evento relacionado é AuditMembershipAuthenticationFailure.

Quando um WebAuthenticationFailureAuditEvent é gerado, por padrão, ele atualiza o contador de desempenho eventos de falha de autenticação de auditoria gerados. Para exibir esse contador de desempenho no Monitor do Sistema (PerfMon), na janela Adicionar Contadores , selecione ASP.NET na lista suspensa Objeto desempenho , selecione o contador de desempenho Eventos de Falha de Autenticação Gerados e clique no botão Adicionar . Para obter mais informações, consulte Usando o Monitor do Sistema (PerfMon) com aplicativos ASP.NET.

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 WebAuthenticationFailureAuditEvent classe , consulte o exemplo fornecido neste tópico.

Construtores

WebAuthenticationFailureAuditEvent(String, Object, Int32, Int32, String)

Inicializa uma nova instância da classe WebAuthenticationFailureAuditEvent com os parâmetros de evento especificados.

WebAuthenticationFailureAuditEvent(String, Object, Int32, String)

Inicializa uma nova instância da classe WebAuthenticationFailureAuditEvent com os parâmetros de evento especificados.

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)
NameToAuthenticate

Obtém o nome do usuário a ser autenticado.

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.

(Herdado de WebFailureAuditEvent)
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)

Aplica-se a

Confira também