SessionAuthenticationModule.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 erstellt 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
Der folgende Code zeigt einen Handler für das SessionSecurityTokenCreated in der global.asax.cs-Datei einer ASP.NET Webanwendung implementierte Ereignis. Sie müssen dem Ereignis auch den Handler hinzufügen. Ein vollständiges Beispiel wird im SessionAuthenticationModule Übersichtsthema gezeigt.
void SessionAuthenticationModule_SessionSecurityTokenCreated(object sender, SessionSecurityTokenCreatedEventArgs e)
{
System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenCreated event");
//Store session on the server-side token cache instead writing the whole token to the cookie.
//It may improve throughput but introduces server affinity that may affect scalability
FederatedAuthentication.SessionAuthenticationModule.IsReferenceMode = true;
}
Hinweise
Sie können dieses Ereignis verwenden, um das Sitzungssicherheitstoken zu ändern, bevor es in ein Cookie geschrieben wird.
Das SessionSecurityTokenCreated Ereignis wird innerhalb der OnAuthenticateRequest Methode ausgelöst, nachdem ein Sitzungstoken (SessionSecurityToken) erstellt wurde. Dies geschieht beispielsweise, wenn ein Ereignishandler für das SessionSecurityTokenReceived Ereignis das Token ändert.
Sie können dieses Ereignis verwenden, um die Eigenschaften des Sitzungstokens zu ändern, bevor es weiter entlang der Pipeline übergeben wird und verwendet wird, um die Entität zu authentifizieren, die die Anforderung (Benutzer) stellt.
In einem Ereignishandler können Sie über die SessionSecurityTokenCreatedEventArgs.SessionToken Eigenschaft auf das Token zugreifen. Nachdem Sie das Token geändert haben, können Sie sicherstellen, dass es wieder in das Cookie geschrieben wird, indem Sie die SessionSecurityTokenCreatedEventArgs.WriteSessionCookie Eigenschaft auf truefestlegen. Im Gegensatz dazu ist das SessionSecurityTokenCreated Ereignis SessionSecurityTokenCreated kein abbruchfähiges Ereignis.
