WindowsAuthenticationModule.Authenticate Evento

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Ocorre quando o aplicativo autentica a solicitação atual.

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 

Tipo de evento

WindowsAuthenticationEventHandler

Exemplos

O exemplo de código a seguir usa o evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext como um objeto personalizado 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

Comentários

O Authenticate evento é gerado durante o AuthenticateRequest evento.

Você pode acessar o Authenticate evento da WindowsAuthenticationModule classe especificando uma sub-rotina chamada WindowsAuthentication_OnAuthenticate no arquivo Global.asax para seu aplicativo ASP.NET.

Você pode usar a User propriedade do WindowsAuthenticationEventArgs objeto fornecido ao evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext como um objeto personalizado IPrincipal . Se você não especificar um valor para a User propriedade durante o evento WindowsAuthentication_OnAuthenticate , a identidade do Windows fornecida pelo IIS será usada como a identidade da solicitação atual. Se o IIS usar autenticação anônima, a Identity propriedade será definida como a identidade retornada pelo GetAnonymous método .

O evento WindowsAuthentication_OnAuthenticate é gerado somente quando a autenticação Mode é definida Windows como e o WindowsAuthenticationModule é um módulo HTTP ativo para o aplicativo.

Observação

No IIS 7.0 em execução no Modo Integrado, o Authenticate evento do WindowsAuthenticationModule não é gerado quando os módulos ASP.NET WindowsAuthenticationModule e IIS AnonymousAuthenticationModule estão habilitados. Nesse cenário, para receber a notificação de autenticação, assine o AuthenticateRequest evento da HttpApplication instância. Para obter mais informações sobre problemas de compatibilidade em modos integrados, consulte Movendo um aplicativo ASP.NET do IIS 6.0 para o IIS 7.0.

Confira também

• Provedor de Autenticação do Windows