WindowsAuthenticationModule.Authenticate Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando a aplicação autentica o pedido 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
Exemplos
O exemplo de código seguinte utiliza o evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext para 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
Observações
O Authenticate evento é levantado durante o AuthenticateRequest evento.
Pode aceder ao evento Authenticate da classe WindowsAuthenticationModule especificando uma sub-rotina chamada WindowsAuthentication_OnAuthenticate no ficheiro Global.asax da sua aplicação ASP.NET.
Pode usar a User propriedade do WindowsAuthenticationEventArgs objeto fornecida ao evento WindowsAuthentication_OnAuthenticate para definir a User propriedade do atual HttpContext para um objeto personalizado IPrincipal . Se não especificar um valor para a propriedade User durante o evento WindowsAuthentication_OnAuthenticate, a identidade Windows fornecida pelo IIS é usada como identidade para o pedido atual. Se o IIS usar autenticação anónima, então a Identity propriedade é definida para a identidade devolvida pelo GetAnonymous método.
O evento WindowsAuthentication_OnAuthenticate é ativado apenas quando a autenticação Mode está definida para Windows e a WindowsAuthenticationModule é um módulo HTTP ativo para a aplicação.
Note
No IIS 7.0 a correr em Modo Integrado, o evento Authenticate do WindowsAuthenticationModule não é ativado quando tanto o módulo ASP.NET WindowsAuthenticationModule como o IIS AnonymousAuthenticationModule estão ativados. Neste cenário, para receber notificações de autenticação, subscreva o AuthenticateRequest evento da HttpApplication instância. Para mais informações sobre questões de compatibilidade em modos integrados, consulte Moving an ASP.NET Application do IIS 6.0 para o IIS 7.0.