SessionAuthenticationModule.SessionSecurityTokenReceived Ereignis

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Tritt ein, wenn ein Sitzungssicherheitstoken von einem Cookie gelesen wurde.

public:
 event EventHandler<System::IdentityModel::Services::SessionSecurityTokenReceivedEventArgs ^> ^ SessionSecurityTokenReceived;

public event EventHandler<System.IdentityModel.Services.SessionSecurityTokenReceivedEventArgs> SessionSecurityTokenReceived;

member this.SessionSecurityTokenReceived : EventHandler<System.IdentityModel.Services.SessionSecurityTokenReceivedEventArgs> 

Public Event SessionSecurityTokenReceived As EventHandler(Of SessionSecurityTokenReceivedEventArgs) 

Ereignistyp

EventHandler<SessionSecurityTokenReceivedEventArgs>

Beispiele

Der folgende Code zeigt einen Handler für das Ereignis, das SessionSecurityTokenReceived in der Datei global.asax.cs einer ASP.NET Webanwendung implementiert ist. Außerdem müssen Sie dem Ereignis den Handler hinzufügen. Ein ausführlicheres Beispiel finden Sie im Übersichtsthema SessionAuthenticationModule .

void SessionAuthenticationModule_SessionSecurityTokenReceived(object sender, SessionSecurityTokenReceivedEventArgs e)
{
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenReceived event");
}

Hinweise

Das SessionSecurityTokenReceived Ereignis wird innerhalb der OnAuthenticateRequest -Methode ausgelöst, nachdem ein Sitzungstoken (SessionSecurityToken) erfolgreich aus dem Sitzungscookies gelesen wurde.

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). Eines der häufigsten Szenarien ist das Ändern der Sitzungsablaufzeit (auf die über die SessionSecurityToken.ValidTo -Eigenschaft zugegriffen werden kann), um die in der Konfiguration festgelegte Sitzungsablaufzeit über das lifetime Attribut des <sessionTokenRequirement-Elements> zu überschreiben. Wenn Sie diese Eigenschaft für jede Anforderung ändern, können Sie eine gleitende Sitzung implementieren. d. h. eine Sitzung, in der die Lebensdauer jedes Mal verlängert wird, wenn der Benutzer auf die Website zugreift.

In einem Ereignishandler können Sie über die -Eigenschaft auf das SessionSecurityTokenReceivedEventArgs.SessionToken Token zugreifen. Nachdem Sie das Token geändert haben, können Sie sicherstellen, dass es in das Cookie zurückgeschrieben wird, indem Sie auf SessionSecurityTokenReceivedEventArgs.ReissueCookietruefestlegen. Schließlich ist das SessionSecurityTokenReceived Ereignis ein abbrechbares Ereignis, und Sie können die Cancel -Eigenschaft des festlegen, um die SessionSecurityTokenReceivedEventArgs weitere Verarbeitung der Anforderung abzubrechen.