WebAuthenticationSuccessAuditEvent Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zawiera informacje o pomyślnych zdarzeniach uwierzytelniania.
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
- Dziedziczenie
-
WebAuthenticationSuccessAuditEvent
Przykłady
Ten przykład kodu zawiera dwie części: fragment pliku konfiguracji, a następnie kod pokazujący sposób dostosowywania WebAuthenticationSuccessAuditEvent zdarzenia.
Poniżej przedstawiono fragment sekcji i eventMappings
plików provider
konfiguracji. Są one już ustawione domyślnie. Jedyną rzeczą, którą należy wykonać, jest zapewnienie konfiguracji elementu rules
w healthMonitoring
sekcji .
<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>
Poniższy kod pokazuje, jak dostosować WebAuthenticationSuccessAuditEvent zdarzenie.
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
Uwagi
ASP.NET monitorowanie kondycji umożliwia pracownikom produkcyjnym i operacyjnym zarządzanie wdrożonych aplikacji internetowych. System.Web.Management Przestrzeń nazw zawiera typy zdarzeń kondycji odpowiedzialnych za pakowanie danych o stanie kondycji aplikacji i typów dostawców odpowiedzialnych za przetwarzanie tych danych. Zawiera również typy pomocnicze, które ułatwiają zarządzanie zdarzeniami kondycji.
Poniższa lista zawiera opis funkcji, dla których ASP.NET zgłasza zdarzenia typu WebAuthenticationSuccessAuditEvent.
Uwaga
Domyślnie ASP.NET jest skonfigurowany do rejestrowania tylko warunków niepowodzenia inspekcji, ponieważ warunki powodzenia rejestrowania mogą poważnie obciążać zasoby systemowe. Zawsze można skonfigurować system do rejestrowania warunków powodzenia.
Uwierzytelnianie formularzy. Warunki pomyślne są poddawane inspekcji. Inspekcje powodzenia obejmują nazwę użytkownika, która została uwierzytelniona. Zamiast tego inspekcje niepowodzeń nie zawierają nazwy użytkownika, ponieważ zazwyczaj wynikają one z biletu, który zakończył się niepowodzeniem odszyfrowywania lub walidacji. Oba zawierają adres IP klienta. Powiązany kod inspekcji zdarzeń to AuditFormsAuthenticationSuccess.
Członkostwa. Warunki pomyślne są poddawane inspekcji. Inspekcje powodzenia i niepowodzenia zawierają nazwę użytkownika, która została podjęta. Żadna forma inspekcji nie będzie zawierać hasła, które próbowano podjąć, ponieważ może to spowodować utrwalone prawidłowe hasło w dzienniku. Powiązany kod inspekcji zdarzeń to AuditMembershipAuthenticationSuccess.
Gdy element WebAuthenticationSuccessAuditEvent zostanie zgłoszony, domyślnie aktualizuje licznik wydajności Zdarzenia powodzenia uwierzytelniania. Aby wyświetlić ten licznik wydajności w monitorze systemu (PerfMon), w oknie Dodawanie liczników wybierz ASP.NET z listy rozwijanej Obiekt wydajności , wybierz licznik powodzenia uwierzytelniania podniósł wydajność i kliknij przycisk Dodaj . Aby uzyskać więcej informacji, zobacz Using the System Monitor (PerfMon) with ASP.NET Applications (Używanie monitora systemu (PerfMon) z aplikacjami ASP.NET.
Uwaga
W większości przypadków będzie można użyć ASP.NET typów monitorowania kondycji zgodnie z implementacją i będziesz kontrolować system monitorowania kondycji, określając wartości w healthMonitoring
sekcji konfiguracji. Możesz również pochodzić z typów monitorowania kondycji, aby utworzyć własne niestandardowe zdarzenia i dostawców. Przykład wyprowadzania z klasy można znaleźć w przykładzie WebBaseEvent podanym w tym temacie.
Konstruktory
WebAuthenticationSuccessAuditEvent(String, Object, Int32, Int32, String) |
Inicjuje klasę WebSuccessAuditEvent przy użyciu podanych parametrów. |
WebAuthenticationSuccessAuditEvent(String, Object, Int32, String) |
Inicjuje klasę WebAuthenticationSuccessAuditEvent przy użyciu podanych parametrów. |
Właściwości
EventCode |
Pobiera wartość kodu skojarzona ze zdarzeniem. (Odziedziczone po WebBaseEvent) |
EventDetailCode |
Pobiera kod szczegółów zdarzenia. (Odziedziczone po WebBaseEvent) |
EventID |
Pobiera identyfikator skojarzony ze zdarzeniem. (Odziedziczone po WebBaseEvent) |
EventOccurrence |
Pobiera licznik reprezentujący liczbę przypadków wystąpienia zdarzenia. (Odziedziczone po WebBaseEvent) |
EventSequence |
Pobiera liczbę przypadków zgłoszenia zdarzenia przez aplikację. (Odziedziczone po WebBaseEvent) |
EventSource |
Pobiera obiekt, który zgłasza zdarzenie. (Odziedziczone po WebBaseEvent) |
EventTime |
Pobiera czas zgłoszenia zdarzenia. (Odziedziczone po WebBaseEvent) |
EventTimeUtc |
Pobiera czas zgłoszenia zdarzenia. (Odziedziczone po WebBaseEvent) |
Message |
Pobiera komunikat opisujący zdarzenie. (Odziedziczone po WebBaseEvent) |
NameToAuthenticate |
Pobiera nazwę uwierzytelnionego użytkownika. |
ProcessInformation |
Pobiera informacje o ASP.NET procesie hostingu aplikacji. (Odziedziczone po WebManagementEvent) |
RequestInformation |
Pobierz informacje skojarzone z żądaniem internetowym. (Odziedziczone po WebAuditEvent) |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
FormatCustomEventDetails(WebEventFormatter) |
Zapewnia standardowe formatowanie informacji o zdarzeniu. (Odziedziczone po WebBaseEvent) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
IncrementPerfCounters() |
Zwiększa liczbę zgłoszonych liczników wydajności zdarzeń powodzenia inspekcji. (Odziedziczone po WebSuccessAuditEvent) |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
Raise() |
Zgłasza zdarzenie, powiadamiając każdego skonfigurowanego dostawcę o wystąpieniu zdarzenia. (Odziedziczone po WebBaseEvent) |
ToString() |
Formatuje informacje o zdarzeniach do celów wyświetlania. (Odziedziczone po WebBaseEvent) |
ToString(Boolean, Boolean) |
Formatuje informacje o zdarzeniach do celów wyświetlania. (Odziedziczone po WebBaseEvent) |