DefaultAuthenticationModule Classe

  • Referência

Definição

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Garante que um objeto de autenticação esteja presente no contexto. Essa classe não pode ser herdada.

public ref class DefaultAuthenticationModule sealed : System::Web::IHttpModule
public sealed class DefaultAuthenticationModule : System.Web.IHttpModule
type DefaultAuthenticationModule = class
    interface IHttpModule
Public NotInheritable Class DefaultAuthenticationModule
Implements IHttpModule
Herança
Object
DefaultAuthenticationModule
Implementações
IHttpModule

Exemplos

O exemplo 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 DefaultAuthenticationModule garante que a User propriedade da instância atual HttpContext esteja definida como um IPrincipal objeto para cada solicitação. O DefaultAuthenticationModule examina a User propriedade após o AuthenticateRequest evento e antes do AuthorizeRequest evento. Se a User propriedade for null, o definirá DefaultAuthenticationModule a User propriedade como um GenericPrincipal objeto que não contém informações do usuário.

Se o módulo de autenticação definir a StatusCode propriedade como 401, a DefaultAuthenticationModule renderizará uma página de erro negada pelo acesso. Se o valor da StatusCode propriedade for definido como um valor maior que 200, o DefaultAuthenticationModule objeto encerrará a solicitação. Nesse caso, somente os módulos HTTP que assinam o EndRequest evento são chamados antes da conclusão da solicitação atual.

O DefaultAuthenticationModule expõe um Authenticate evento. Você pode usar esse evento para fornecer um objeto personalizado IPrincipal para a User propriedade da instância atual HttpContext . O Authenticate evento é acessado especificando um evento chamado DefaultAuthentication_OnAuthenticate no arquivo Global.asax do aplicativo.

Construtores

DefaultAuthenticationModule()

Inicializa uma nova instância da classe DefaultAuthenticationModule.

Métodos

Dispose()

Libera todos os recursos, exceto a memória, usados pelo DefaultAuthenticationModule.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Init(HttpApplication)

Inicializa o objeto DefaultAuthenticationModule.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Eventos

Authenticate

Ocorre depois que a solicitação foi autenticada.

Aplica-se a

Confira também