SessionAuthenticationModule.OnAuthenticateRequest(Object, EventArgs) Méthode

Définition

Espace de noms:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Gère l’événement AuthenticateRequest à partir du pipeline 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)

Paramètres

sender

Object

Source de l’événement. Il s’agit d’un HttpApplication objet.

eventArgs

EventArgs

Données de l’événement.

Exceptions

InvalidOperationException

Il n’existe pas de gestionnaire de jetons de session valide configuré. (Il n’y a pas SessionSecurityTokenHandler de configuration dans la SecurityTokenHandlers propriété.)

Remarques

Cette méthode effectue les opérations suivantes :

1. Appelle la TryReadSessionTokenFromCookie méthode pour lire un SessionSecurityToken cookie de session, le cas échéant.

2. Si un jeton de sécurité de session ne peut pas être lu (probablement parce qu’une session n’a pas été établie), retournez.

3. Appelle la OnSessionSecurityTokenReceived méthode pour déclencher l’événement SessionSecurityTokenReceived . Cela permet au jeton lu à partir du cookie d’être modifié ou de demander l’annulation de la demande. Le gestionnaire peut également spécifier que le jeton doit être réédité en définissant la SessionSecurityTokenReceivedEventArgs.ReissueCookie propriété.

4. Si le jeton doit être réédité, supprime-le du cache et appelle la OnSessionSecurityTokenCreated méthode pour déclencher l’événement SessionSecurityTokenCreated . Cela permet de modifier à nouveau le jeton. Le comportement de réédition peut également être modifié en définissant la SessionSecurityTokenCreatedEventArgs.WriteSessionCookie propriété dans le gestionnaire d’événements.

5. Appelle la AuthenticateSessionSecurityToken méthode pour authentifier l’utilisateur. Si elle réussit, cela a l’effet de définir la Thread.CurrentPrincipal propriété sur le principal contenu dans la SessionSecurityToken.ClaimsPrincipal propriété du jeton entrant.

6. Si la session a expiré, appelle la SignOut méthode.

La OnAuthenticateRequest méthode est ajoutée aux gestionnaires de l’événement HttpApplication.AuthenticateRequest dans la InitializeModule méthode.