DefaultAuthenticationModule Classe

Definizione

Spazio dei nomi:

System.Web.Security

Assembly:

System.Web.dll

Garantisce che un oggetto di autenticazione sia presente nel contesto. La 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 usato 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 con un Name valore "default".

Nota

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 , poiché 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

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

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

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

Costruttori

DefaultAuthenticationModule()

Inizializza una nuova istanza della classe DefaultAuthenticationModule.

Metodi

Dispose()	Rilascia tutte le risorse, diverse dalla memoria, utilizzate 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 l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init(HttpApplication)	Inizializza l'oggetto DefaultAuthenticationModule.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Eventi

Authenticate

Viene generato dopo che la richiesta è stata autenticata.

Vedi anche

• Autenticazione ASP.NET