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 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 Identity dell'oggetto GenericPrincipal è un GenericIdentity con valore Name "default".

Nota

L'evento DefaultAuthentication_OnAuthenticate viene generato prima dell'eventoAuthorizeRequest. 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 , in quanto 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 User proprietà dopo l'evento AuthenticateRequest e prima dell'evento AuthorizeRequest . Se la User proprietà è null, la DefaultAuthenticationModule proprietà viene impostata User su un GenericPrincipal oggetto che non contiene informazioni sull'utente.

Se il modulo di autenticazione imposta la StatusCode proprietà su 401, verrà DefaultAuthenticationModule 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

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