WebAuditEvent クラス

定義

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

public class WebAuditEvent : System.Web.Management.WebManagementEvent

type WebAuditEvent = class
    inherit WebManagementEvent

Public Class WebAuditEvent
Inherits WebManagementEvent

継承

Object

WebBaseEvent

WebManagementEvent

WebAuditEvent

派生

System.Web.Management.WebFailureAuditEvent

System.Web.Management.WebSuccessAuditEvent

例

次のコード例は、 クラスから WebAuditEvent 派生してカスタム監査イベントを作成する方法を示しています。

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

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

        // Invoked in case of events identified only by their event code.
        public SampleWebAuditEvent(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 SampleWebAuditEvent(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 SampleWebAuditEvent.
        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()
        {
            // Obtain the Web request information.
            // No customization is allowed here.
            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(
                "******** SampleWebAuditEvent Information 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(
                "******** SampleWebAuditEvent Information End ********");

            formatter.IndentationLevel -= 1;
        }
    }
}

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


' Implements a custom WebAuditEvent class. 

Public Class SampleWebAuditEvent
    Inherits System.Web.Management.WebAuditEvent
    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 SampleWebAuditEvent.
    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 
        ' Obtain the Web request information.
        ' No customization is allowed here.
        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("******** SampleWebAuditEvent Information 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("******** SampleWebAuditEvent Information End ********")
        
        formatter.IndentationLevel -= 1
    
    End Sub
End Class

ASP.NET がイベントを使用できるようにする構成ファイルの抜粋を次に示します。

<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="SampleWebAuditEvent"   
      type="SamplesAspNet.SampleWebAuditEvent,  
      webauditevent,Version=1.0.1663.31140,   
      Culture=neutral,   
      PublicKeyToken=0d1fa0f69d94de96,   
      processorArchitecture=MSIL"/>  
  </eventMappings>  

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

</healthMonitoring>  

注釈

ASP.NET 正常性の監視により、運用スタッフと運用スタッフはデプロイされた Web アプリケーションを管理できます。 System.Web.Management名前空間には、アプリケーションの正常性状態データをパッケージ化する正常性イベントの種類と、このデータの処理を担当するプロバイダーの種類が含まれています。 また、正常性イベントの管理中に役立つサポート型も含まれています。

クラスは WebAuditEvent 、ASP.NET 正常性監視監査イベント クラスの派生元となる基底クラスです。 監査イベントは、Web アプリケーションのセキュリティ関連の操作に関する情報を生成し、監査された操作ごとに成功イベントと失敗イベントの両方を提供します。

正常性監視システムは、成功したイベントと失敗したイベントの両方を監査できます。つまり、アプリケーションは通常の状態と誤動作状態の両方を監視できます。 既定では、失敗監査イベントのみが記録されます。

次の操作は ASP.NET によって監査され、成功または失敗の正常性監視監査イベントが生成される可能性があります。

• ASP.NET アプリケーションのユーザーが行ったログイン試行。 この監査の詳細については、 と WebSuccessAuditEventを参照してくださいWebAuthenticationSuccessAuditEvent。

• 認証エラー、リソース アクセス試行の失敗、その他のセキュリティ関連のイベントなど、セキュリティ関連のイベント。 これらのイベントのログは、アプリケーションに対する侵入または攻撃を調査するときに役立ちます。 既定では、匿名ユーザーの承認エラーに対する監査サポートは提供されません。 エラー イベント監査の詳細については、 と WebFailureAuditEventを参照してくださいWebAuthenticationFailureAuditEvent。

• ASP.NET アプリケーションによって発生するカスタム イベント。 クラスと派生クラスによって WebAuditEvent 提供される機能を拡張することで、カスタム イベントを監査できます

注意 (継承者)

カスタム イベント情報を表示用に書式設定する場合は、 メソッドではなく メソッドをToStringオーバーライドFormatCustomEventDetails(WebEventFormatter)します。 これにより、機密性の高いシステム情報の上書きや改ざんを回避できます。

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• WebManagementEvent
• WebFailureAuditEvent
• WebAuthenticationFailureAuditEvent
• WebSuccessAuditEvent
• WebAuthenticationSuccessAuditEvent
• WebViewStateFailureAuditEvent
• WebEventCodes
• ASP.NET 正常性監視の概要