WSFederationAuthenticationModule.SessionSecurityTokenCreated Událost

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

Nastane, když je token zabezpečení relace vytvořen z tokenu zabezpečení přijatého ze služby tokenů zabezpečení (STS).

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) 

Event Type

EventHandler<SessionSecurityTokenCreatedEventArgs>

Příklady

void WSFederationAuthenticationModule_SessionSecurityTokenCreated(object sender, SessionSecurityTokenCreatedEventArgs e)
{
    //Manipulate session token here, for example, changing its expiration value
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenCreated event");
    System.Diagnostics.Trace.WriteLine("Key valid from: " + e.SessionToken.KeyEffectiveTime);
    System.Diagnostics.Trace.WriteLine("Key expires on: " + e.SessionToken.KeyExpirationTime);
}

Poznámky

Můžete přidat obslužnou rutinu události pro úpravu tokenu relace předtím, než se použije k nastavení objektu zabezpečení vlákna a zapíše se do souboru cookie relace. V obslužné rutině události můžete získat přístup k tokenu relace prostřednictvím SessionSecurityTokenCreatedEventArgs.SessionToken vlastnosti . Nastavením vlastnosti můžete určit, jestli má být soubor cookie relace zapsán SessionSecurityTokenCreatedEventArgs.WriteSessionCookie .

Tato událost je vyvolána uvnitř OnAuthenticateRequest delegáta obslužné rutiny události při zpracování WS-Federation přihlašovací zprávy ("wsignin1.0") přijaté ze služby tokenů zabezpečení (STS). Vyvolá se těsně po ověření tokenu zabezpečení, který byl deserializován z wresult nebo parametru wresultptr ve zprávě odpovědi na přihlášení, a před nastavením Thread.CurrentPrincipal objektu zabezpečení pro (a vlastnost UserHttpContext.Current).

Důležité

Pokud chcete provozovat relace v referenčním režimu, microsoft doporučuje poskytnout obslužnou rutinu WSFederationAuthenticationModule.SessionSecurityTokenCreated události v souboru global.asax.cs a nastavit SessionSecurityToken.IsReferenceMode vlastnost tokenu předaného ve SessionSecurityTokenCreatedEventArgs.SessionToken vlastnosti. Tím se zajistí, že token relace bude fungovat v referenčním režimu pro každý požadavek a bude upřednostňován před pouhým nastavením SessionAuthenticationModule.IsReferenceMode vlastnosti v modulu ověřování relace.