WebSuccessAuditEvent Sınıf

Tanım

Ad Alanı:

System.Web.Management

Bütünleştirilmiş Kod:

System.Web.dll

Başarılı güvenlik olayları hakkında bilgi sağlar.

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

public class WebSuccessAuditEvent : System.Web.Management.WebAuditEvent

type WebSuccessAuditEvent = class
    inherit WebAuditEvent

Public Class WebSuccessAuditEvent
Inherits WebAuditEvent

Devralma

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

WebSuccessAuditEvent

Türetilmiş

System.Web.Management.WebAuthenticationSuccessAuditEvent

Örnekler

Aşağıdaki kod örneği, özel denetim olayı oluşturmak için sınıfından WebSuccessAuditEvent türetme işlemini gösterir.

using System;
using System.Text;
using System.Web;
using System.Web.Management;

namespace SamplesAspNet
{
    // Implements a custom WebSuccessAuditEvent class. 
    public class SampleWebSuccessAuditEvent :
        System.Web.Management.WebSuccessAuditEvent
    {
        private string customCreatedMsg, customRaisedMsg;

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

            formatter.IndentationLevel -= 1;
        }
    }
}

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


' Implements a custom WebSuccessAuditEvent class. 

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

        formatter.IndentationLevel -= 1

    End Sub
End Class

Aşağıdaki örnek, ASP.NET sistem durumu izlemesinin olayı kullanmasını sağlayan yapılandırma dosyasının bir alıntısıdır.

<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="SampleWebSuccessAuditEvent"
      type="SamplesAspNet.SampleWebSuccessAuditEvent,
      websuccessauditevent,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>

Açıklamalar

ASP.NET sistem durumunu izleme, üretim ve operasyon personelinin dağıtılan Web uygulamalarını yönetmesine olanak tanır. Ad alanı, System.Web.Management uygulama sistem durumu verilerini paketlemeden sorumlu sistem durumu olay türlerini ve bu verileri işlemeden sorumlu sağlayıcı türlerini içerir. Ayrıca, sistem durumu olaylarının yönetimi sırasında yardımcı olan destekleyici türler içerir.

WebSuccessAuditEvent sınıfı, güvenlikle ilgili başarılı bir işlem gerçekleştiğinde kullanılır. Bunun bir örneği, web isteği için başarılı bir URL yetkilendirmesidir.

Aşağıdaki listede, WebSuccessAuditEvent türündeki olayların ASP.NET tarafından tetiklendiği özellikler açıklanmaktadır:

• Dosya Yetkilendirme. Başarılı koşullar denetleniyor. Dosya yetkilendirme, yalnızca bir Windows Kimliği istekle ilişkilendirildiğinde ASP.NET tarafından denenmiştir. İlgili olay denetim kodu şeklindedir AuditFileAuthorizationSuccess.

• URL Yetkilendirme. Yetkilendirmenin verildiği BIR URL kaynağına erişimi belirtir. Başarılı koşullar denetleniyor. İlgili olay denetim kodu şeklindedir AuditUrlAuthorizationSuccess.

• Diğer güvenlik koşulları. aşağıda ilgili olay kodlarının listesi verilmiştir:

  • AuditFormsAuthenticationSuccess

  • AuditMembershipAuthenticationSuccess

bir WebSuccessAuditEvent oluşturulduğunda, sistem durumu izleme ASP.NET ilgili Denetim Başarısı Olayları Yükseltilmiş performans sayacını artırır ve ardından healthMonitoring yapılandırmasını denetleyip herhangi bir sağlayıcının olaya abone olup olmadığını belirler. Sağlayıcılar olaya abone olursa, ASP.NET işlenmek üzere olayı onlara iletir.

Note

Sistem İzleyicisi'nde (PerfMon) BaşarıYı Denetle Olayı Yükseltilmiş performans sayacını görüntülemek için, Add Counters penceresinde Performance nesnesinden ASP.NET öğesini seçin açılan listesinden, Audit Success Event Raised performans sayacını seçin, ve Add düğmesine tıklayın. Daha fazla bilgi için bkz. Uyg ASP.NET Uygulama Performansı.

Başarılı denetimler beklenen bir koşulu temsil ettiğinden, bunlara abone olmak istemeyebilirsiniz. Siteye erişim denetimi sağlamak için bunlara abone olabilirsiniz.

Note

Çoğu durumda, uygulanan ASP.NET sistem durumu izleme türlerini kullanabilir ve healthMonitoring yapılandırma bölümünde değerleri belirterek sistem durumu izleme sistemini denetleyebilirsiniz. Kendi özel olaylarınızı ve sağlayıcılarınızı oluşturmak için sistem durumu izleme türlerinden de türetebilirsiniz. sınıfından türetme WebSuccessAuditEvent örneği için bu konuda sağlanan örne bakın.

Oluşturucular

Name	Description
WebSuccessAuditEvent(String, Object, Int32, Int32)	Sağlanan parametreleri kullanarak sınıfının yeni bir örneğini WebSuccessAuditEvent başlatır.
WebSuccessAuditEvent(String, Object, Int32)	Sağlanan parametreleri kullanarak sınıfının yeni bir örneğini WebSuccessAuditEvent başlatır.

Özellikler

Name	Description
EventCode	Olayla ilişkili kod değerini alır. (Devralındığı yer: WebBaseEvent)
EventDetailCode	Olay ayrıntı kodunu alır. (Devralındığı yer: WebBaseEvent)
EventID	Olayla ilişkili tanımlayıcıyı alır. (Devralındığı yer: WebBaseEvent)
EventOccurrence	Olayın kaç kez gerçekleştiğini gösteren bir sayaç alır. (Devralındığı yer: WebBaseEvent)
EventSequence	Olayın uygulama tarafından kaç kez tetiklendiğini alır. (Devralındığı yer: WebBaseEvent)
EventSource	Olayı tetikleyen nesneyi alır. (Devralındığı yer: WebBaseEvent)
EventTime	Olayın oluşturulduğu zamanı alır. (Devralındığı yer: WebBaseEvent)
EventTimeUtc	Olayın oluşturulduğu zamanı alır. (Devralındığı yer: WebBaseEvent)
Message	Olayı açıklayan iletiyi alır. (Devralındığı yer: WebBaseEvent)
ProcessInformation	ASP.NET uygulama barındırma işlemi hakkında bilgi alır. (Devralındığı yer: WebManagementEvent)
RequestInformation	Web isteğiyle ilişkili bilgileri alın. (Devralındığı yer: WebAuditEvent)

Yöntemler

Name	Description
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FormatCustomEventDetails(WebEventFormatter)	Olay bilgilerinin standart biçimlendirmesini sağlar. (Devralındığı yer: WebBaseEvent)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IncrementPerfCounters()	Denetim Başarı Olayları Yükseltilmiş performans sayacını artırır.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
Raise()	Yapılandırılmış sağlayıcılara olayın gerçekleştiğini bildirerek bir olay oluşturur. (Devralındığı yer: WebBaseEvent)
ToString()	Olay bilgilerini görüntüleme amacıyla biçimlendirin. (Devralındığı yer: WebBaseEvent)
ToString(Boolean, Boolean)	Olay bilgilerini görüntüleme amacıyla biçimlendirin. (Devralındığı yer: WebBaseEvent)

Ayrıca bkz.

• WebAuditEvent
• WebFailureAuditEvent
• WebEventCodes
• ASP.NET Sistem Durumu İzleyicisi Genel Bakış