WindowsAuthenticationModule.Authenticate Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.Security
Zestaw:
System.Web.dll

Występuje, gdy aplikacja uwierzytelnia bieżące żądanie.

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

Typ zdarzenia

WindowsAuthenticationEventHandler

Przykłady

W poniższym przykładzie kodu użyto zdarzenia WindowsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego HttpContext obiektu na obiekt niestandardowy IPrincipal .

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

Uwagi

Zdarzenie Authenticate jest zgłaszane podczas AuthenticateRequest zdarzenia.

Dostęp do zdarzenia WindowsAuthenticationModule klasy można uzyskaćAuthenticate, określając podproceduty o nazwie WindowsAuthentication_OnAuthenticate w pliku Global.asax dla aplikacji ASP.NET.

Możesz użyć User właściwości obiektu dostarczonego WindowsAuthenticationEventArgs do zdarzenia WindowsAuthentication_OnAuthenticate , aby ustawić User właściwość bieżącego HttpContext obiektu na obiekt niestandardowy IPrincipal . Jeśli nie określisz wartości właściwości User podczas zdarzenia WindowsAuthentication_OnAuthenticate , tożsamość systemu Windows dostarczona przez usługi IIS będzie używana jako tożsamość bieżącego żądania. Jeśli usługi IIS używają uwierzytelniania anonimowego, Identity właściwość jest ustawiona na tożsamość zwróconą przez metodę GetAnonymous .

Zdarzenie WindowsAuthentication_OnAuthenticate jest zgłaszane tylko wtedy, gdy uwierzytelnianie Mode jest ustawione na Windows i WindowsAuthenticationModule jest aktywnym modułem HTTP dla aplikacji.

Uwaga

W usługach IIS 7.0 uruchomionych w trybie zintegrowanym zdarzenie WindowsAuthenticationModule nie jest zgłaszane, Authenticate gdy włączono zarówno ASP.NET, WindowsAuthenticationModule jak i moduły usług IISAnonymousAuthenticationModule. W tym scenariuszu, aby otrzymywać AuthenticateRequest powiadomienia uwierzytelniania, subskrybuj zdarzenie HttpApplication wystąpienia. Aby uzyskać więcej informacji na temat problemów ze zgodnością w trybach zintegrowanych, zobacz Przenoszenie aplikacji ASP.NET z usług IIS 6.0 do usług IIS 7.0.

Dotyczy

Zobacz też