DefaultAuthenticationModule.Authenticate Evento

Definição

Namespace:

System.Web.Security

Assembly:

System.Web.dll

Ocorre depois que a solicitação foi autenticada.

public:
 event System::Web::Security::DefaultAuthenticationEventHandler ^ Authenticate;

public event System.Web.Security.DefaultAuthenticationEventHandler Authenticate;

member this.Authenticate : System.Web.Security.DefaultAuthenticationEventHandler 

Public Custom Event Authenticate As DefaultAuthenticationEventHandler 

Tipo de evento

DefaultAuthenticationEventHandler

Exemplos

O exemplo de código a seguir usa o evento DefaultAuthentication_OnAuthenticate para testar se a User propriedade da instância atual HttpContext é null. Se a User propriedade for null, o exemplo definirá a User propriedade da instância atual HttpContext como um GenericPrincipal objeto em que o IdentityGenericPrincipal do objeto é um GenericIdentity com um Name valor de "padrão".

Observação

O evento DefaultAuthentication_OnAuthenticate é gerado antes do AuthorizeRequest evento. Como resultado, se você definir a User propriedade da instância atual HttpContext como uma identidade personalizada, ela poderá afetar o comportamento do aplicativo. Por exemplo, se você estiver usando a FormsAuthentication classe e especificar <deny users="?" /> na seção de configuração de autorização para garantir que apenas usuários autenticados tenham acesso ao seu site, este exemplo fará com que o elemento deny seja ignorado, pois o usuário terá um nome, que é "padrão". Em vez disso, você especificaria <deny users="default" /> para garantir que apenas usuários autenticados possam acessar seu site.

public void DefaultAuthentication_OnAuthenticate(object sender,
                                                 DefaultAuthenticationEventArgs args)
{
  if (args.Context.User == null)
    args.Context.User = 
      new System.Security.Principal.GenericPrincipal(
        new System.Security.Principal.GenericIdentity("default"),
        new String[0]);
}

Public Sub DefaultAuthentication_OnAuthenticate(sender As Object, _
                                                args As DefaultAuthenticationEventArgs)
  If args.Context.User Is Nothing Then
    args.Context.User = _
      new System.Security.Principal.GenericPrincipal( _
        new System.Security.Principal.GenericIdentity("default"), _
        new String(0) {})
  End If
End Sub

Comentários

O Authenticate evento é gerado após o AuthenticateRequest evento. Ele é usado para garantir que a User propriedade da instância atual HttpContext seja preenchida com um IPrincipal objeto .

Você pode acessar o Authenticate evento da DefaultAuthenticationModule classe especificando uma sub-rotina chamada DefaultAuthentication_OnAuthenticate no arquivo Global.asax do aplicativo.

Você pode usar a Context propriedade do DefaultAuthenticationEventArgs objeto no evento DefaultAuthentication_OnAuthenticate para definir a User propriedade da instância atual HttpContext como um objeto personalizado IPrincipal . Se você não especificar um valor para a User propriedade , o definirá DefaultAuthenticationModule a User propriedade da HttpContext instância como um GenericPrincipal objeto que não contém informações do usuário.

O evento DefaultAuthentication_OnAuthenticate é gerado após o AuthenticateRequest evento e antes do AuthorizeRequest evento. Se você tiver uma authorization seção que depende do nome de usuário para negar ou permitir o acesso ao aplicativo, modificar a User propriedade da instância atual HttpContext poderá afetar o comportamento do aplicativo. Verifique se o nome de usuário definido durante o evento DefaultAuthentication_OnAuthenticate é considerado quando você especifica a seção de autorização em sua configuração.

Observação

Se o aplicativo Web estiver em execução no IIS 7.0 no modo integrado, o Authenticate evento do DefaultAuthenticationModule não será gerado. Se o mode atributo do elemento de configuração de autenticação estiver definido como "Nenhum" e o aplicativo assinar o Authenticate evento, um PlatformNotSupportedException erro será gerado. 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 no modo integrado, consulte Movendo um aplicativo de ASP.NET do IIS 6.0 para o IIS 7.0.

Confira também

• Autenticação do ASP.NET