SessionAuthenticationModule.SessionSecurityTokenReceived Událost

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

Nastane, když se token zabezpečení relace načte 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 události implementované v souboru global.asax.cs webové aplikace ASP.NET. Obslužnou rutinu musíte také přidat do události. Podrobně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 OnAuthenticateRequest metody po úspěšném načtení tokenu relace zSessionSecurityToken souboru cookie relace.

Tuto událost můžete použít k úpravě vlastností tokenu relace před jeho předáním v kanálu a slouží k ověření entity, která provádí požadavek (uživatel). Jedním z nejběžnějších scénářů je úprava doby vypršení platnosti relace (přístupná prostřednictvím SessionSecurityToken.ValidTo vlastnosti) k přepsání času vypršení platnosti relace nastaveného 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á, že relace, ve které je životnost prodloužena pokaždé, když uživatel přistupuje k webu.

V obslužné rutině události můžete získat přístup k tokenu SessionSecurityTokenReceivedEventArgs.SessionToken prostřednictvím vlastnosti. Po úpravě tokenu můžete zajistit, že se zapíše zpět do souboru cookie nastavením SessionSecurityTokenReceivedEventArgs.ReissueCookie na truehodnotu . SessionSecurityTokenReceived Nakonec je událost zrušenou událostí a můžete nastavit Cancel vlastnost SessionSecurityTokenReceivedEventArgs pro přerušení dalšího zpracování požadavku.