WindowsAuthenticationModule.Authenticate イベント

定義

アプリケーションが現在の要求を認証するときに発生します。

public:
 event System::Web::Security::WindowsAuthenticationEventHandler ^ Authenticate;
public event System.Web.Security.WindowsAuthenticationEventHandler Authenticate;
member this.Authenticate : System.Web.Security.WindowsAuthenticationEventHandler 
Public Custom Event Authenticate As WindowsAuthenticationEventHandler 

イベントの種類

次のコード例では、WindowsAuthentication_OnAuthenticate イベントを使用して、現在HttpContextの の プロパティをカスタム IPrincipal オブジェクトに設定Userします。

public void WindowsAuthentication_OnAuthenticate(object sender, WindowsAuthenticationEventArgs args)
{
  if (!args.Identity.IsAnonymous)
  {
    args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
  }
}
Public Sub WindowsAuthentication_OnAuthenticate(sender As Object, args As WindowsAuthenticationEventArgs)
  If Not args.Identity.IsAnonymous Then
    args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
  End If
End Sub

注釈

イベントは Authenticate 、イベント中に発生します AuthenticateRequest

クラスの イベントに Authenticate アクセスするには、ASP.NET アプリケーションの WindowsAuthenticationModule Global.asax ファイルで WindowsAuthentication_OnAuthenticate という名前のサブルーチンを指定します。

WindowsAuthentication_OnAuthenticate イベントにUser指定された オブジェクトの WindowsAuthenticationEventArgs プロパティを使用して、現在HttpContextの のプロパティをカスタム IPrincipal オブジェクトに設定Userできます。 WindowsAuthentication_OnAuthenticate イベント中に プロパティのUser値を指定しない場合、IIS によって提供される Windows ID が現在の要求の ID として使用されます。 IIS が匿名認証を使用する Identity 場合、 プロパティは メソッドによって GetAnonymous 返される ID に設定されます。

WindowsAuthentication_OnAuthenticate イベントは、認証Modeが にWindows設定されていてWindowsAuthenticationModule、 がアプリケーションのアクティブな HTTP モジュールである場合にのみ発生します。

注意

統合モードで実行されている IIS 7.0 では、AuthenticateASP.NET WindowsAuthenticationModule と IIS AnonymousAuthenticationModule モジュールのWindowsAuthenticationModule両方が有効になっている場合、 のイベントは発生しません。 このシナリオでは、認証通知を受信するには、 インスタンスの AuthenticateRequest イベントを HttpApplication サブスクライブします。 統合モードでの互換性の問題の詳細については、「 ASP.NET アプリケーションを IIS 6.0 から IIS 7.0 に移動する」を参照してください。

適用対象

こちらもご覧ください