SessionAuthenticationModule.SessionSecurityTokenCreated Événement

Définition

Espace de noms:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Se produit lorsqu’un jeton de sécurité de session a été créé.

public:
 event EventHandler<System::IdentityModel::Services::SessionSecurityTokenCreatedEventArgs ^> ^ SessionSecurityTokenCreated;

public event EventHandler<System.IdentityModel.Services.SessionSecurityTokenCreatedEventArgs> SessionSecurityTokenCreated;

member this.SessionSecurityTokenCreated : EventHandler<System.IdentityModel.Services.SessionSecurityTokenCreatedEventArgs> 

Public Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs) 

Type d'événement

EventHandler<SessionSecurityTokenCreatedEventArgs>

Exemples

Le code suivant montre un gestionnaire pour l’événement SessionSecurityTokenCreated implémenté dans le fichier global.asax.cs d’une application web ASP.NET. Vous devez également ajouter le gestionnaire à l’événement. Un exemple plus complet est illustré dans la rubrique vue d’ensemble SessionAuthenticationModule .

void SessionAuthenticationModule_SessionSecurityTokenCreated(object sender, SessionSecurityTokenCreatedEventArgs e)
{
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenCreated event");
    //Store session on the server-side token cache instead writing the whole token to the cookie.
    //It may improve throughput but introduces server affinity that may affect scalability
    FederatedAuthentication.SessionAuthenticationModule.IsReferenceMode = true;
}

Remarques

Vous pouvez utiliser cet événement pour modifier le jeton de sécurité de session avant d’être écrit dans un cookie.

L’événement SessionSecurityTokenCreated est déclenché à partir de la OnAuthenticateRequest méthode après la création d’un jeton de session (SessionSecurityToken). Cela se produit, par exemple, si un gestionnaire d’événements pour l’événement SessionSecurityTokenReceived modifie le jeton.

Vous pouvez utiliser cet événement pour modifier les propriétés du jeton de session avant qu’il ne soit transmis plus loin le long du pipeline et qu’il est utilisé pour authentifier l’entité qui effectue la requête (utilisateur).

Dans un gestionnaire d’événements, vous pouvez accéder au jeton via la SessionSecurityTokenCreatedEventArgs.SessionToken propriété. Après avoir modifié le jeton, vous pouvez vous assurer qu’il est réécrit dans le cookie en définissant la SessionSecurityTokenCreatedEventArgs.WriteSessionCookie propriété sur true. Contrairement à l’événement, SessionSecurityTokenCreated n’est SessionSecurityTokenCreated pas un événement annulable.