WindowsAuthenticationModule.Authenticate Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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 para o 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 de ASP.NET do IIS 6.0 para o IIS 7.0.
