WebFailureAuditEvent クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

WebFailureAuditEvent クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

セキュリティ障害に関する情報を提供します。

名前空間: System.Web.Management
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class WebFailureAuditEvent
    Inherits WebAuditEvent

Visual Basic (使用法)

Dim instance As WebFailureAuditEvent

public class WebFailureAuditEvent : WebAuditEvent

C++

public ref class WebFailureAuditEvent : public
 WebAuditEvent

public class WebFailureAuditEvent extends WebAuditEvent

JScript

public class WebFailureAuditEvent extends
 WebAuditEvent

解説

運用および操作の担当者は、ASP.NET Health Monitoring を使用して、配置されている Web アプリケーションを管理できます。System.Web.Management 名前空間には、アプリケーションの状態データをパッケージ化する状態イベント型、およびそのデータを処理するプロバイダ型が含まれます。また、状態イベント管理を支援するサポート型も含まれます。

WebFailureAuditEvent クラスは、セキュリティ操作が失敗すると使用されます。たとえば、Web 要求に対する URL 承認が失敗した場合です。

既定では、ASP.NET は次の機能について WebFailureAuditEvent イベントを発生させるよう構成されています。

ファイルの承認。ASP.NET では、ファイルの承認を Windows ID が要求に関連付けられている場合にだけ実施します。関連するイベント監査コードは AuditFileAuthorizationFailure です。
URL の承認。URL リソースに対する承認されていないアクセスを制御します。匿名ユーザーによる試行の失敗は監査されません。一般的な環境では、匿名ユーザーの認証エラーは許容されるからです。関連するイベント監査コードは AuditUrlAuthorizationFailure です。
汎用未処理状態またはセキュリティ未処理状態。次の一覧に、これらの条件に関連するイベントコードを示します。
- AuditFormsAuthenticationFailure
- AuditMembershipAuthenticationFailure
- AuditInvalidViewStateFailure
- AuditUnhandledSecurityException
- AuditUnhandledAccessException

WebFailureAuditEvent イベントが発生すると、ASP.NET Health Monitoring は関連する Audit Failure Events Raised パフォーマンスカウンタをインクリメントし、healthMonitoring 構成をチェックしてそのイベントをサブスクライブするプロバイダがあるかどうかを確認します。このイベントをサブスクライブするプロバイダがある場合、ASP.NET はそのイベントをディスパッチして処理させます。

メモ
Audit Failure Events Raised パフォーマンスカウンタをシステムモニタ (PerfMon) に表示するには、[カウンタの追加] ウィンドウで [パフォーマンスオブジェクト] ドロップダウンリストの [ASP.NET] を選択し、[Audit Failure Events Raised] パフォーマンスカウンタを選択して、[追加] ボタンをクリックします。詳細については、MSDN の IIS に関するドキュメントの「Using the System Monitor (PerfMon) with ASP.NET Applications」を参照してください。メモほとんどの場合、ASP.NET 状態監視型は実装のまま使用でき、healthMonitoring 構成セクションに値を指定して ASP.NET Health Monitoring system を制御できます。状態監視型の派生として独自のイベントおよびプロバイダを作成することもできます。WebFailureAuditEvent クラスの派生の例については、このトピックの例を参照してください。

メモ

Audit Failure Events Raised パフォーマンスカウンタをシステムモニタ (PerfMon) に表示するには、[カウンタの追加] ウィンドウで [パフォーマンスオブジェクト] ドロップダウンリストの [ASP.NET] を選択し、[Audit Failure Events Raised] パフォーマンスカウンタを選択して、[追加] ボタンをクリックします。詳細については、MSDN の IIS に関するドキュメントの「Using the System Monitor (PerfMon) with ASP.NET Applications」を参照してください。メモほとんどの場合、ASP.NET 状態監視型は実装のまま使用でき、healthMonitoring 構成セクションに値を指定して ASP.NET Health Monitoring system を制御できます。状態監視型の派生として独自のイベントおよびプロバイダを作成することもできます。WebFailureAuditEvent クラスの派生の例については、このトピックの例を参照してください。

継承時の注意 カスタムイベント情報を表示用に書式設定する場合は、ToString メソッドではなく、FormatCustomEventDetails メソッドをオーバーライドします。これにより、重要なシステム情報に対する上書きや不正な変更を防げます。

使用例

WebFailureAuditEvent クラスの派生としてカスタム監査イベントを作成する方法を次のコード例に示します。

Visual Basic

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


' Implements a custom WebFailureAuditEvent class. 

Public Class SampleWebFailureAuditEvent
    Inherits System.Web.Management.WebFailureAuditEvent
    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 'New
    
    
    ' 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 'New
    
    
    
    ' Raises the SampleWebFailureAuditEvent.
    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 'Raise
    
    
    ' 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("******** SampleWebFailureAuditEvent
 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("******** SampleWebFailureAuditEvent
 End ********")

        formatter.IndentationLevel -= 1

    End Sub 'FormatCustomEventDetails
 

End Class 'SampleWebFailureAuditEvent

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

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


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

            formatter.IndentationLevel -= 1;

        }
    }

}

次に示すのは、ASP.NET で WebFailureAuditEvent イベントを使用できるようにする方法を示す構成の抜粋です。

<healthMonitoring

enabled="true"
heartBeatInterval="0">

<providers>

<eventMappings>

<rules>

</healthMonitoring>

継承階層

System.Object
   System.Web.Management.WebBaseEvent
     System.Web.Management.WebManagementEvent
       System.Web.Management.WebAuditEvent
        System.Web.Management.WebFailureAuditEvent
           System.Web.Management.WebAuthenticationFailureAuditEvent
           System.Web.Management.WebViewStateFailureAuditEvent

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WebFailureAuditEvent メンバ
System.Web.Management 名前空間
WebAuditEvent クラス
WebSuccessAuditEvent
WebEventCodes クラス
その他の技術情報
healthMonitoring 要素 (ASP.NET 設定スキーマ)
ASP.NET の状態監視
ASP.NET ビューステート

>> 「WebFailureAuditEvent クラス」を含む用語の索引
WebFailureAuditEvent クラスのページへのリンク

WebFailureAuditEvent クラスとは？わかりやすく解説

WebFailureAuditEvent クラス

「WebFailureAuditEvent クラス」の関連用語


	© 2025 Microsoft.All rights reserved.

WebFailureAuditEvent クラスとは？ わかりやすく解説

WebFailureAuditEvent クラス

急上昇のことば

「WebFailureAuditEvent クラス」の関連用語

WebFailureAuditEvent クラスとは？わかりやすく解説