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 ein, 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 Ereignis, das SessionSecurityTokenCreated in der global.asax.cs-Datei einer ASP.NET-Webanwendung implementiert ist. Sie müssen dem Ereignis auch den Handler hinzufügen. Ein vollständiges Beispiel finden Sie im Übersichtsthema SessionAuthenticationModule .
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 zum Authentifizieren der Entität verwendet wird, die die Anforderung stellt (Benutzer).
In einem Ereignishandler können Sie über die -Eigenschaft auf das SessionSecurityTokenCreatedEventArgs.SessionToken Token zugreifen. Nachdem Sie das Token geändert haben, können Sie sicherstellen, dass es in das Cookie zurückgeschrieben wird, indem Sie die SessionSecurityTokenCreatedEventArgs.WriteSessionCookie -Eigenschaft auf true
festlegen. Im Gegensatz dazu ist das SessionSecurityTokenCreated Ereignis SessionSecurityTokenCreated kein abbruchfähiges Ereignis.