Поделиться через


WebAuthenticationSuccessAuditEvent Класс

Определение

Представляет сведения об успешных событиях проверки подлинности.

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
Наследование

Примеры

Этот пример кода состоит из двух частей: фрагмент файла конфигурации, за которым следует код, показывающий WebAuthenticationSuccessAuditEvent , как настроить событие.

Ниже приведен фрагмент раздела файла provider конфигурации и eventMappings . Они уже заданы по умолчанию. Единственное, что нужно сделать, — указать настройку rules для элемента в healthMonitoring разделе .

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

В следующем коде показано, как настроить WebAuthenticationSuccessAuditEvent событие.


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

Комментарии

ASP.NET мониторинг работоспособности позволяет рабочим и операционным сотрудникам управлять развернутыми веб-приложениями. Пространство System.Web.Management имен содержит типы событий работоспособности, отвечающие за упаковку данных о состоянии работоспособности приложения, и типы поставщиков, ответственные за обработку этих данных. Он также содержит вспомогательные типы, которые помогают во время управления событиями работоспособности.

В следующем списке описаны функции, для которых ASP.NET вызывает события типа WebAuthenticationSuccessAuditEvent.

Примечание

По умолчанию ASP.NET настроено для ведения журнала только условий сбоя аудита, так как условия успешного ведения журнала могут сильно напрягать системные ресурсы. Вы всегда можете настроить систему для регистрации условий успешного выполнения.

  • Проверка подлинности с помощью форм. Выполняется аудит успешных условий. Аудит успешного выполнения включает имя пользователя, прошедшего проверку подлинности. Вместо этого аудиты сбоев не включают имя пользователя, так как они обычно являются результатом запроса, который не удалось расшифровать или проверить. Оба содержат IP-адрес клиента. Соответствующий код аудита события — AuditFormsAuthenticationSuccess.

  • Членство. Выполняется аудит успешных условий. Аудит успешности и неудачи содержит имя пользователя, которое было предприняло попытку. Ни в том, ни вном виде аудита не будет содержаться пароль, который был предпринят, так как это может риском сохранить действительный пароль в журнале. Соответствующий код аудита события — AuditMembershipAuthenticationSuccess.

WebAuthenticationSuccessAuditEvent При возникновении по умолчанию обновляется счетчик производительности "События успешного выполнения проверки подлинности". Чтобы просмотреть этот счетчик производительности в системном мониторе (PerfMon), в окне Добавление счетчиков выберите ASP.NET в раскрывающемся списке Объект производительности , выберите счетчик производительности События успешного выполнения проверки подлинности и нажмите кнопку Добавить . Дополнительные сведения см. в разделе Использование системного монитора (PerfMon) с приложениями ASP.NET.

Примечание

В большинстве случаев вы сможете использовать ASP.NET типы мониторинга работоспособности, как реализовано, и вы будете управлять системой мониторинга работоспособности, указывая значения в healthMonitoring разделе конфигурации. Вы также можете наследоваться от типов мониторинга работоспособности для создания собственных пользовательских событий и поставщиков. Пример наследования от WebBaseEvent класса см. в примере, приведенном в этом разделе.

Конструкторы

WebAuthenticationSuccessAuditEvent(String, Object, Int32, Int32, String)

Инициализирует класс WebSuccessAuditEvent, используя предоставленные параметры.

WebAuthenticationSuccessAuditEvent(String, Object, Int32, String)

Инициализирует класс WebAuthenticationSuccessAuditEvent, используя предоставленные параметры.

Свойства

EventCode

Получает значение кода, связанное с событием.

(Унаследовано от WebBaseEvent)
EventDetailCode

Получает подробный код события.

(Унаследовано от WebBaseEvent)
EventID

Получает идентификатор, связанный с событием.

(Унаследовано от WebBaseEvent)
EventOccurrence

Получает значение счетчика, показывающее, сколько раз произошло событие.

(Унаследовано от WebBaseEvent)
EventSequence

Получает количество порождений события приложением.

(Унаследовано от WebBaseEvent)
EventSource

Получает объект, порождающий событие.

(Унаследовано от WebBaseEvent)
EventTime

Получает время порождения события.

(Унаследовано от WebBaseEvent)
EventTimeUtc

Получает время порождения события.

(Унаследовано от WebBaseEvent)
Message

Получает сообщение, описывающее событие.

(Унаследовано от WebBaseEvent)
NameToAuthenticate

Получает имя пользователя, прошедшего проверку подлинности.

ProcessInformation

Получает сведения о размещающем приложение процессе ASP.NET.

(Унаследовано от WebManagementEvent)
RequestInformation

Получает сведения, связанные с веб-запросом.

(Унаследовано от WebAuditEvent)

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
FormatCustomEventDetails(WebEventFormatter)

Обеспечивает стандартное форматирование сведений о событии.

(Унаследовано от WebBaseEvent)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
IncrementPerfCounters()

Увеличивает значение счетчика "Событий аудита успехов".

(Унаследовано от WebSuccessAuditEvent)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
Raise()

Порождает событие, уведомляя любого настроенного поставщика о произошедшем событии.

(Унаследовано от WebBaseEvent)
ToString()

Форматирует сведения события для последующего отображения.

(Унаследовано от WebBaseEvent)
ToString(Boolean, Boolean)

Форматирует сведения события для последующего отображения.

(Унаследовано от WebBaseEvent)

Применяется к

См. также раздел