DefaultAuthenticationModule

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

DefaultAuthenticationModule イベント

パブリック イベント

	名前	説明
	Authenticate	要求が認証された後に発生します。

参照

関連項目

DefaultAuthenticationModule クラス
System.Web.Security 名前空間

その他の技術情報

ASP.NET の認証
Global.asax 構文

DefaultAuthenticationModule クラス

認証オブジェクトがコンテキストに必ず存在するようにします。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 DefaultAuthenticationModule
    Implements IHttpModule

Visual Basic (使用法)

Dim instance As DefaultAuthenticationModule

C#

public sealed class DefaultAuthenticationModule
 : IHttpModule

C++

public ref class DefaultAuthenticationModule
 sealed : IHttpModule

J#

public final class DefaultAuthenticationModule
 implements IHttpModule

JScript

public final class DefaultAuthenticationModule
 implements IHttpModule

解説

DefaultAuthenticationModule は、現在の HttpContext の User プロパティが各要求の IPrincipal オブジェクトに必ず設定されるようにします。DefaultAuthenticationModule は、AuthenticateRequest イベントの後と AuthorizeRequest イベントの前に User プロパティをチェックします。User プロパティが null 参照 (Visual Basic では Nothing) の場合、DefaultAuthenticationModule は User プロパティに、ユーザー情報が含まれていない GenericPrincipal オブジェクトを設定します。

認証モジュールが StatusCode プロパティを 401 に設定する場合、DefaultAuthenticationModule は特別なアクセス拒否エラー ページを出力します。StatusCode プロパティの値が 200 を超える値に設定された場合、DefaultAuthenticationModule オブジェクトは要求を終了し、現在の要求の完了前に EndRequest イベントをサブスクライブする HTTP モジュールのみが呼び出されます。

DefaultAuthenticationModule は Authenticate イベントを公開します。このイベントにより、現在の HttpContext の User プロパティにカスタム IPrincipal オブジェクトを設定できます。Authenticate イベントには、ASP.NET アプリケーションの Global.asax ファイルに、DefaultAuthentication_OnAuthenticate というイベントを指定することによってアクセスします。

使用例

DefaultAuthentication_OnAuthenticate イベントを使用して、現在の HttpContext の User プロパティが null 参照 (Visual Basic では Nothing) かどうかをテストするコード例を次に示します。User プロパティが null 参照 (Visual Basic では Nothing) の場合、サンプル コードでは、現在の HttpContext の User プロパティに GenericPrincipal オブジェクトが設定され、このとき、GenericPrincipal オブジェクトの Identity は Name 値が "default" の GenericIdentity になります。

メモ
DefaultAuthentication_OnAuthenticate イベントは、AuthorizeRequest イベントの前に発生します。結果、現在の HttpContext の User プロパティにカスタム ID を設定すると、アプリケーションの動作に影響を与える場合があります。たとえば、FormsAuthentication クラスを使用して、認証されたユーザーしかサイトにアクセスできないように authorization 構成セクションに <deny users="?" /> と指定している場合、このサンプル コードでは、ユーザーは "default" という名前を持つため deny 要素が無視されます。この場合、<deny users="default" /> と指定すると、認証されたユーザーのみがサイトにアクセスできるようになります。

Visual Basic

Public Sub DefaultAuthentication_OnAuthenticate(sender
 As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing
 Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"),
 _
        new String(0) {})
  End If
End Sub

C#

public void DefaultAuthentication_OnAuthenticate(object
 sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default")
,
        new String[0]);
}

継承階層

System.Object
  System.Web.Security.DefaultAuthenticationModule

スレッド セーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DefaultAuthenticationModule メンバ
System.Web.Security 名前空間
その他の技術情報
ASP.NET の認証
Global.asax 構文

DefaultAuthenticationModule コンストラクタ

DefaultAuthenticationModule クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DefaultAuthenticationModule

C#

public DefaultAuthenticationModule ()

C++

public:
DefaultAuthenticationModule ()

J#

public DefaultAuthenticationModule ()

JScript

public function DefaultAuthenticationModule
 ()

解説

このコンストラクタは、アプリケーション コードから呼び出すためのものではありません。

ASP.NET は、このコンストラクタを呼び出して、DefaultAuthenticationModule クラスのインスタンスを作成します。コンストラクタを呼び出すと、コンストラクタは Init メソッドを呼び出して新しい DefaultAuthenticationModule オブジェクトを初期化します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
DefaultAuthenticationModule クラス
DefaultAuthenticationModule メンバ
System.Web.Security 名前空間
その他の技術情報
ASP.NET の認証

DefaultAuthenticationModule メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Dispose	DefaultAuthenticationModule で使用されていたすべてのリソース (メモリを除く) を解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Init	DefaultAuthenticationModule オブジェクトを初期化します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

DefaultAuthenticationModule クラス
System.Web.Security 名前空間

その他の技術情報

ASP.NET の認証
Global.asax 構文

DefaultAuthenticationModule メンバ

認証オブジェクトがコンテキストに必ず存在するようにします。このクラスは継承できません。

DefaultAuthenticationModule データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	DefaultAuthenticationModule	DefaultAuthenticationModule クラスの新しいインスタンスを初期化します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Dispose	DefaultAuthenticationModule で使用されていたすべてのリソース (メモリを除く) を解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Init	DefaultAuthenticationModule オブジェクトを初期化します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

パブリック イベント

	名前	説明
	Authenticate	要求が認証された後に発生します。

参照

関連項目

DefaultAuthenticationModule クラス
System.Web.Security 名前空間

その他の技術情報

ASP.NET の認証
Global.asax 構文