DefaultAuthenticationModule Classe

Definição

Espaço de Nomes:
System.Web.Security
Assemblagem:
System.Web.dll

Assegura que um objeto de autenticação está presente no contexto. Esta 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 seguinte usa o evento DefaultAuthentication_OnAuthenticate para testar se a User propriedade da instância atual HttpContext é null. Se a User propriedade for null, então a amostra define a User propriedade da instância atual HttpContext para um GenericPrincipal objeto onde o Identity do GenericPrincipal objeto é a GenericIdentity com um Name valor de "default".

Note

O evento DefaultAuthentication_OnAuthenticate é levantado antes do AuthorizeRequest evento. Como resultado, se definir a User propriedade da instância atual HttpContext para uma identidade personalizada, isso pode afetar o comportamento da sua aplicação. Por exemplo, se estiver a usar a FormsAuthentication classe e especificar <deny users="?" /> na secção de configuração de autorização garantir que apenas utilizadores autenticados tenham acesso ao seu site, este exemplo fará com que o elemento de negação seja ignorado, pois o utilizador terá um nome, que é "default". Em vez disso, especificaria <deny users="default" /> garantir que apenas utilizadores autenticados possam aceder ao 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

Observações

Assegura DefaultAuthenticationModule que a User propriedade da instância atual HttpContext é definida para um IPrincipal objeto para cada pedido. Examina DefaultAuthenticationModule a User propriedade após o AuthenticateRequest evento e antes do AuthorizeRequest evento. Se a User propriedade for null, então DefaultAuthenticationModule define a User propriedade para um GenericPrincipal objeto que não contém qualquer informação do utilizador.

Se o módulo de autenticação definir a StatusCode propriedade para 401, aparecerá DefaultAuthenticationModule uma página de erro de acesso negado. Se o valor da StatusCode propriedade for definido para um valor superior a 200, o DefaultAuthenticationModule objeto terminará o pedido. Nesse caso, apenas os módulos HTTP que subscrevem o EndRequest evento são chamados antes da conclusão do pedido atual.

Revela DefaultAuthenticationModule um Authenticate evento. Pode usar este evento para fornecer um objeto personalizado IPrincipal para a User propriedade da instância atual HttpContext . O Authenticate evento é acedido especificando um evento chamado DefaultAuthentication_OnAuthenticate no ficheiro Global.asax da aplicação.

Construtores

Name Description
DefaultAuthenticationModule()

Inicializa uma nova instância da DefaultAuthenticationModule classe.

Métodos

Name Description
Dispose()

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

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(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 atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
Authenticate

Ocorre depois de o pedido ter sido autenticado.

Aplica-se a

Ver também