Condividi tramite


SessionAuthenticationModule.OnAuthenticateRequest(Object, EventArgs) Metodo

Definizione

Gestisce l'evento AuthenticateRequest dalla pipeline di ASP.NET.

protected:
 virtual void OnAuthenticateRequest(System::Object ^ sender, EventArgs ^ eventArgs);
protected virtual void OnAuthenticateRequest(object sender, EventArgs eventArgs);
abstract member OnAuthenticateRequest : obj * EventArgs -> unit
override this.OnAuthenticateRequest : obj * EventArgs -> unit
Protected Overridable Sub OnAuthenticateRequest (sender As Object, eventArgs As EventArgs)

Parametri

sender
Object

Origine dell'evento. Si tratta di un HttpApplication oggetto .

eventArgs
EventArgs

Dati per l'evento.

Eccezioni

Non è configurato un gestore di token di sessione valido. Non è SessionSecurityTokenHandler stato configurato nella SecurityTokenHandlers proprietà .

Commenti

Questo metodo esegue le operazioni seguenti:

  1. Richiama il TryReadSessionTokenFromCookie metodo per leggere un SessionSecurityToken oggetto dal cookie di sessione, se presente.

  2. Se non è possibile leggere un token di sicurezza della sessione (probabilmente perché non è stata stabilita una sessione), restituire.

  3. Richiama il OnSessionSecurityTokenReceived metodo per generare l'evento SessionSecurityTokenReceived . In questo modo è possibile modificare il token letto dal cookie o per annullare la richiesta. Il gestore può anche specificare che il token deve essere riemesso impostando la SessionSecurityTokenReceivedEventArgs.ReissueCookie proprietà .

  4. Se il token deve essere riemesso, lo rimuove dalla cache e richiama il OnSessionSecurityTokenCreated metodo per generare l'evento SessionSecurityTokenCreated . In questo modo è possibile modificare nuovamente il token. Il comportamento di riemissione può anche essere modificato impostando la SessionSecurityTokenCreatedEventArgs.WriteSessionCookie proprietà nel gestore eventi.

  5. Richiama il AuthenticateSessionSecurityToken metodo per autenticare l'utente. In caso di esito positivo, questa operazione ha l'effetto di impostare la Thread.CurrentPrincipal proprietà sull'entità contenuta nella SessionSecurityToken.ClaimsPrincipal proprietà del token in ingresso.

  6. Se la sessione è scaduta, richiama il SignOut metodo .

Il OnAuthenticateRequest metodo viene aggiunto ai gestori per l'evento HttpApplication.AuthenticateRequest nel InitializeModule metodo .

Si applica a