Condividi tramite

DefaultAuthenticationModule Classe

Definizione

Spazio dei nomi:
System.Web.Security
Assembly:
System.Web.dll

Assicura che nel contesto sia presente un oggetto di autenticazione. Questa classe non può essere ereditata.

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
Ereditarietà
Object
DefaultAuthenticationModule
Implementazioni
IHttpModule

Esempio

Nell'esempio seguente viene utilizzato l'evento DefaultAuthentication_OnAuthenticate per verificare se la User proprietà dell'istanza corrente HttpContext è null. Se la User proprietà è null, l'esempio imposta la User proprietà dell'istanza corrente HttpContext su un GenericPrincipal oggetto in cui l'oggetto IdentityGenericPrincipal è un GenericIdentity oggetto con valore Name "default".

Annotazioni

L'evento DefaultAuthentication_OnAuthenticate viene generato prima dell'evento AuthorizeRequest . Di conseguenza, se si imposta la User proprietà dell'istanza corrente HttpContext su un'identità personalizzata, può influire sul comportamento dell'applicazione. Ad esempio, se si usa la FormsAuthentication classe e si specifica <deny users="?" /> nella sezione di configurazione dell'autorizzazione per assicurarsi che solo gli utenti autenticati abbiano accesso al sito, questo esempio causerà l'ignorare l'elemento deny , perché l'utente avrà un nome, che è "predefinito". È invece necessario specificare <deny users="default" /> per assicurarsi che solo gli utenti autenticati possano accedere al sito.

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

Commenti

DefaultAuthenticationModule garantisce che la User proprietà dell'istanza corrente HttpContext sia impostata su un IPrincipal oggetto per ogni richiesta. DefaultAuthenticationModule Esamina la User proprietà dopo l'evento AuthenticateRequest e prima dell'eventoAuthorizeRequest. Se la User proprietà è null, imposta DefaultAuthenticationModule la User proprietà su un GenericPrincipal oggetto che non contiene informazioni sull'utente.

Se il modulo di autenticazione imposta la StatusCode proprietà su 401, DefaultAuthenticationModule verrà visualizzata una pagina di errore di accesso negato. Se il valore della StatusCode proprietà è impostato su un valore maggiore di 200, l'oggetto DefaultAuthenticationModule terminerà la richiesta. In tal caso, vengono chiamati solo i moduli HTTP che sottoscrivono l'evento EndRequest prima del completamento della richiesta corrente.

DefaultAuthenticationModule Espone un Authenticate evento. È possibile utilizzare questo evento per fornire un oggetto personalizzato IPrincipal per la User proprietà dell'istanza corrente HttpContext . L'evento Authenticate è accessibile specificando un evento denominato DefaultAuthentication_OnAuthenticate nel file Global.asax dell'applicazione.

Costruttori

Nome Descrizione
DefaultAuthenticationModule()

Inizializza una nuova istanza della classe DefaultAuthenticationModule.

Metodi

Nome Descrizione
Dispose()

Rilascia tutte le risorse, diverse dalla memoria, usate da DefaultAuthenticationModule.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
Init(HttpApplication)

Inizializza l'oggetto DefaultAuthenticationModule.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi

Nome Descrizione
Authenticate

Si verifica dopo l'autenticazione della richiesta.

Si applica a

Vedi anche