SessionAuthenticationModule.SessionSecurityTokenReceived Událost

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

Vyvolá se při načtení tokenu zabezpečení relace ze souboru 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 Event SessionSecurityTokenReceived As EventHandler(Of SessionSecurityTokenReceivedEventArgs) 

Event Type

EventHandler<SessionSecurityTokenReceivedEventArgs>

Příklady

Následující kód ukazuje obslužnou rutinu SessionSecurityTokenReceived pro událost implementovanou v souboru global.asax.cs webové aplikace ASP.NET. Do události musíte také přidat obslužnou rutinu. Úplnější příklad je uvedený v tématu s přehledem SessionAuthenticationModule .

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

Poznámky

Událost SessionSecurityTokenReceived je vyvolána z metody OnAuthenticateRequest po úspěšném načtení tokenu relace (SessionSecurityToken) ze souboru cookie relace.

Tuto událost můžete použít k úpravě vlastností tokenu relace před jeho předáním dále v kanálu a k ověření entity, která vytvořila požadavek (uživatele). Jedním z nejběžnějších scénářů je úprava doby vypršení platnosti relace (přístupná prostřednictvím SessionSecurityToken.ValidTo vlastnosti), aby se přepsaly čas vypršení platnosti relace nastavený v konfiguraci prostřednictvím lifetime atributu <sessionTokenRequirement> elementu. Úpravou této vlastnosti u každého požadavku můžete implementovat posuvnou relaci; to znamená relaci, ve které se doba života prodlouží pokaždé, když uživatel přistupuje k webu.

V obslužné rutině události můžete k tokenu přistupovat prostřednictvím SessionSecurityTokenReceivedEventArgs.SessionToken vlastnosti . Po úpravě tokenu můžete zajistit, aby se zapsal zpátky do souboru cookie nastavením na SessionSecurityTokenReceivedEventArgs.ReissueCookietrue. SessionSecurityTokenReceived Nakonec je událost zrušitelná a můžete nastavit Cancel vlastnost objektu SessionSecurityTokenReceivedEventArgs tak, aby se přerušila další zpracování požadavku.