DefaultAuthenticationModule Classe

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 "default".

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 somente 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 objeto para cada solicitação IPrincipal . 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, o DefaultAuthenticationModule renderizará uma página de erro de acesso negado. 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.

Confira também

• Autenticação do ASP.NET