WSFederationAuthenticationModule.SessionSecurityTokenCreated Événement

Définition

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é.Occurs when a session security token has been created from the security token received from a security token service (STS).

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

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 est écrit dans le cookie de session.You can add an event handler to modify the session token before it is used to set the thread principal and is written to the session cookie. Dans le gestionnaire d’événements, vous pouvez accéder au jeton de session via la SessionSecurityTokenCreatedEventArgs.SessionToken propriété.In the event handler, you can access the session token through the SessionSecurityTokenCreatedEventArgs.SessionToken property. Vous pouvez spécifier si un cookie de session doit être écrit en définissant la SessionSecurityTokenCreatedEventArgs.WriteSessionCookie propriété.You can specify whether a session cookie should be written by setting the SessionSecurityTokenCreatedEventArgs.WriteSessionCookie property.

Cet événement est déclenché à partir de l’intérieur du OnAuthenticateRequest délégué de gestionnaire d’événements lors du traitement d’un message de réponse de connexion WS-Federation (« wsignin 1.0 ») reçu du service d’émission de jeton de sécurité (STS).This event is raised from inside the OnAuthenticateRequest event-handler delegate when processing a WS-Federation sign-in response message ("wsignin1.0") received from the security token service (STS). Elle est levée juste après la validation du jeton de sécurité qui a été désérialisé à partir de wresult ou du paramètre wresultptr dans le message de réponse de connexion, et avant que le principal des revendications soit défini sur Thread.CurrentPrincipal (et sur la User propriété de HttpContext.Current ).It is raised just after the security token that was deserialized from the wresult or the wresultptr parameter in the sign-in response message has been validated, and before the claims principal is set on the Thread.CurrentPrincipal (and on the User property of HttpContext.Current).

Important

Pour exécuter des sessions en mode de référence, Microsoft recommande de fournir un gestionnaire pour l' WSFederationAuthenticationModule.SessionSecurityTokenCreated événement dans le fichier global.asax.cs et de définir la SessionSecurityToken.IsReferenceMode propriété sur le jeton passé dans la SessionSecurityTokenCreatedEventArgs.SessionToken propriété.To operate sessions in reference mode, Microsoft recommends providing a handler for the WSFederationAuthenticationModule.SessionSecurityTokenCreated event in the global.asax.cs file and setting the SessionSecurityToken.IsReferenceMode property on the token passed in the SessionSecurityTokenCreatedEventArgs.SessionToken property. Cela permet de s’assurer que le jeton de session fonctionne en mode de référence pour chaque demande et qu’il est préférable de définir simplement la SessionAuthenticationModule.IsReferenceMode propriété sur le module d’authentification de session.This will ensure that the session token operates in reference mode for every request and is favored over merely setting the SessionAuthenticationModule.IsReferenceMode property on the Session Authentication Module.

S’applique à