WSFederationAuthenticationModule.SessionSecurityTokenCreated Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn ein Sitzungssicherheitstoken aus dem Sicherheitstoken erstellt wurde, das von einem Sicherheitstokendienst (SECURITY Token Service, STS) empfangen wurde.
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)
Ereignistyp
Beispiele
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);
}
Hinweise
Sie können einen Ereignishandler hinzufügen, um das Sitzungstoken zu ändern, bevor es zum Festlegen des Threadprinzipals verwendet wird und in das Sitzungscookies geschrieben wird. Im Ereignishandler können Sie über die SessionSecurityTokenCreatedEventArgs.SessionToken Eigenschaft auf das Sitzungstoken zugreifen. Sie können angeben, ob ein Sitzungscookies geschrieben werden soll, indem Sie die SessionSecurityTokenCreatedEventArgs.WriteSessionCookie Eigenschaft festlegen.
Dieses Ereignis wird aus dem OnAuthenticateRequest Ereignishandlerdelegat ausgelöst, wenn eine WS-Federation Anmeldeantwortnachricht ("wsignin1.0"), die vom Sicherheitstokendienst (STS) empfangen wird, verarbeitet wird. Sie wird direkt nach dem Sicherheitstoken ausgelöst, das vom wresult oder dem wresultptr-Parameter in der Anmeldeantwort überprüft wurde, und bevor der Anspruchsprinzipal für die Thread.CurrentPrincipal (und für die User Eigenschaft von HttpContext.Current) festgelegt wird.
Von Bedeutung
Um Sitzungen im Referenzmodus auszuführen, empfiehlt Microsoft, einen Handler für das WSFederationAuthenticationModule.SessionSecurityTokenCreated Ereignis in der global.asax.cs-Datei bereitzustellen und die SessionSecurityToken.IsReferenceMode Eigenschaft für das in der SessionSecurityTokenCreatedEventArgs.SessionToken Eigenschaft übergebene Token festzulegen. Dadurch wird sichergestellt, dass das Sitzungstoken für jede Anforderung im Referenzmodus ausgeführt wird und nur die SessionAuthenticationModule.IsReferenceMode Eigenschaft für das Sitzungsauthentifizierungsmodul festgelegt wird.