DefaultAuthenticationModule クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule

public sealed class DefaultAuthenticationModule : System.Web.IHttpModule

type DefaultAuthenticationModule = class
    interface IHttpModule

Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule

継承: Object
DefaultAuthenticationModule

実装: IHttpModule

例

次の例では、 DefaultAuthentication_OnAuthenticate イベントを使用して、 User 現在 HttpContext のインスタンスのプロパティが nullかどうかをテストします。プロパティが User の場合、サンプルではnull、現在HttpContextのインスタンスのプロパティをオブジェクトにGenericPrincipal設定Userします。このIdentityオブジェクトの GenericPrincipal は、の値が Name GenericIdentity "default" です。

注意

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

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]);
}

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

注釈

は DefaultAuthenticationModule 、 User 現在 HttpContext のインスタンスのプロパティが要求ごとにオブジェクトに IPrincipal 設定されていることを確認します。は DefaultAuthenticationModule 、イベントの User 後とイベントの前に AuthenticateRequest プロパティを AuthorizeRequest 調べます。プロパティが User の場合、 nullはDefaultAuthenticationModule、ユーザー情報をGenericPrincipal含まないオブジェクトにプロパティを設定Userします。

認証モジュールでプロパティを StatusCode 401 に設定すると、 DefaultAuthenticationModule によってアクセス拒否エラーページが表示されます。プロパティの値が StatusCode 200 より大きい値に設定されている場合、 DefaultAuthenticationModule オブジェクトは要求を終了します。その場合、現在の要求が完了する前に、イベントを EndRequest サブスクライブする HTTP モジュールのみが呼び出されます。

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

コンストラクター

DefaultAuthenticationModule()

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

メソッド

Dispose()	DefaultAuthenticationModule で使用されていたすべてのリソース (メモリを除く) を解放します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Init(HttpApplication)	DefaultAuthenticationModule オブジェクトを初期化します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

イベント

Authenticate

要求が認証された後に発生します。

適用対象

こちらもご覧ください

ASP.NET 認証

次の方法で共有