WSFederationAuthenticationModule.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éé à partir du jeton de sécurité reçu d'un service d'émission de jeton de sécurité.

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

void WSFederationAuthenticationModule_SessionSecurityTokenCreated(object sender, SessionSecurityTokenCreatedEventArgs e)
{
    //Manipulate session token here, for example, changing its expiration value
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenCreated event");
    System.Diagnostics.Trace.WriteLine("Key valid from: " + e.SessionToken.KeyEffectiveTime);
    System.Diagnostics.Trace.WriteLine("Key expires on: " + e.SessionToken.KeyExpirationTime);
}

Remarques

Vous pouvez ajouter un gestionnaire d’événements pour modifier le jeton de session avant qu’il ne soit utilisé pour définir le principal de thread et qu’il soit écrit dans le cookie de session. Dans le gestionnaire d’événements, vous pouvez accéder au jeton de session via la SessionSecurityTokenCreatedEventArgs.SessionToken propriété . Vous pouvez spécifier si un cookie de session doit être écrit en définissant la SessionSecurityTokenCreatedEventArgs.WriteSessionCookie propriété .

Cet événement est déclenché à partir du délégué du gestionnaire d’événements lors du OnAuthenticateRequest traitement d’un message de réponse de connexion WS-Federation (« wsignin1.0 ») reçu du service STS (Security Token Service). Il est déclenché juste après la validation du jeton de sécurité qui a été désérialisé à partir du paramètre wresult ou wresultptr dans le message de réponse de connexion, et avant que le principal de revendications soit défini sur le Thread.CurrentPrincipal (et sur la User propriété de HttpContext.Current).

Important

Pour utiliser des sessions en mode référence, Microsoft recommande de fournir un gestionnaire pour l’événement WSFederationAuthenticationModule.SessionSecurityTokenCreated dans le fichier global.asax.cs et de définir la SessionSecurityToken.IsReferenceMode propriété sur le jeton transmis dans la SessionSecurityTokenCreatedEventArgs.SessionToken propriété. Cela garantit que le jeton de session fonctionne en mode référence pour chaque requête et est préféré à la simple définition de la SessionAuthenticationModule.IsReferenceMode propriété sur le module d’authentification de session.