SessionAuthenticationModule.SessionSecurityTokenCreated Ereignis

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

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 Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs) 

Ereignistyp

EventHandler<SessionSecurityTokenCreatedEventArgs>

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 truefestlegen. Im Gegensatz dazu ist das SessionSecurityTokenCreated Ereignis SessionSecurityTokenCreated kein abbruchfähiges Ereignis.