SessionAuthenticationModule.SessionSecurityTokenReceived Händelse

Definition

Inträffar när en sessionssäkerhetstoken har lästs från en cookie.

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 Custom Event SessionSecurityTokenReceived As EventHandler(Of SessionSecurityTokenReceivedEventArgs) 
Public Event SessionSecurityTokenReceived As EventHandler(Of SessionSecurityTokenReceivedEventArgs) 

Händelsetyp

Exempel

Följande kod visar en hanterare för händelsen SessionSecurityTokenReceived implementerad i global.asax.cs-filen för en ASP.NET webbapp. Du måste också lägga till hanteraren i händelsen. Ett mer komplett exempel visas i översiktsavsnittet SessionAuthenticationModule .

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

Kommentarer

Händelsen SessionSecurityTokenReceived genereras inifrån OnAuthenticateRequest metoden efter att en sessionstoken (SessionSecurityToken) har lästs från sessionscookien.

Du kan använda den här händelsen för att ändra egenskaperna för sessionstoken innan den skickas vidare längs pipelinen och används för att autentisera entiteten som gör begäran (användaren). Ett av de vanligaste scenarierna är att ändra sessionens förfallotid (tillgänglig via SessionSecurityToken.ValidTo egenskapen) för att åsidosätta sessionens förfallotid som angetts i konfigurationen lifetime via attributet <för sessionTokenRequirement-elementet> . Genom att ändra den här egenskapen för varje begäran kan du implementera en glidande session. det vill: en session där livslängden förlängs varje gång användaren kommer åt webbplatsen.

I en händelsehanterare kan du komma åt token via egenskapen SessionSecurityTokenReceivedEventArgs.SessionToken . När du har modifierat token kan du se till att den skrivs tillbaka till cookien genom att ange SessionSecurityTokenReceivedEventArgs.ReissueCookie till true. Slutligen är händelsen SessionSecurityTokenReceived en avbruten händelse, och du kan ange Cancel egenskapen SessionSecurityTokenReceivedEventArgs för för att avbryta ytterligare bearbetning av begäran.

Gäller för