WSFederationAuthenticationModule.SessionSecurityTokenCreated Evento

Definizione

Spazio dei nomi:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Si verifica quando un token di sicurezza della sessione è stato creato dal token di sicurezza ricevuto da un servizio token di sicurezza (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 Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs) 

Tipo evento

EventHandler<SessionSecurityTokenCreatedEventArgs>

Esempio

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);
}

Commenti

È possibile aggiungere un gestore eventi per modificare il token di sessione prima di usarlo per impostare l'entità thread e viene scritto nel cookie di sessione. Nel gestore eventi è possibile accedere al token di sessione tramite la SessionSecurityTokenCreatedEventArgs.SessionToken proprietà . È possibile specificare se è necessario scrivere un cookie di sessione impostando la SessionSecurityTokenCreatedEventArgs.WriteSessionCookie proprietà .

Questo evento viene generato dall'interno del delegato del gestore eventi durante l'elaborazione OnAuthenticateRequest di un messaggio di risposta di accesso WS-Federation ("wsignin1.0") ricevuto dal servizio token di sicurezza.This event is generate from the event-handler delegate when processing a WS-Federation sign-in response message ("wsignin1.0") received from the security token service (STS). Viene generato subito dopo la convalida del token di sicurezza deserializzato dal wresult o dal parametro wresultptr nel messaggio di risposta di accesso e prima che l'entità attestazioni sia impostata su Thread.CurrentPrincipal (e sulla User proprietà di HttpContext.Current).

Importante

Per gestire le sessioni in modalità riferimento, Microsoft consiglia di fornire un gestore per l'evento WSFederationAuthenticationModule.SessionSecurityTokenCreated nel file global.asax.cs e di impostare la SessionSecurityToken.IsReferenceMode proprietà sul token passato nella SessionSecurityTokenCreatedEventArgs.SessionToken proprietà . In questo modo si garantisce che il token di sessione funzioni in modalità di riferimento per ogni richiesta e che sia preferito semplicemente impostare la SessionAuthenticationModule.IsReferenceMode proprietà nel modulo di autenticazione della sessione.