WSFederationAuthenticationModule.SessionSecurityTokenCreated Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 Custom Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs)
Public Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs)
Type d'événement
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.