SessionAuthenticationModule.OnAuthenticateRequest(Object, EventArgs) Metoda

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

AuthenticateRequest Zpracovává událost z kanálu ASP.NET.

protected:
 virtual void OnAuthenticateRequest(System::Object ^ sender, EventArgs ^ eventArgs);

protected virtual void OnAuthenticateRequest (object sender, EventArgs eventArgs);

abstract member OnAuthenticateRequest : obj * EventArgs -> unit
override this.OnAuthenticateRequest : obj * EventArgs -> unit

Protected Overridable Sub OnAuthenticateRequest (sender As Object, eventArgs As EventArgs)

Parametry

sender

Object

Zdroj události. Toto bude HttpApplication objekt.

eventArgs

EventArgs

Data události

Výjimky

InvalidOperationException

Není nakonfigurována platná obslužná rutina tokenu relace. (Vlastnost není SessionSecurityTokenHandler nakonfigurována SecurityTokenHandlers .)

Poznámky

Tato metoda provede následující:

1. Vyvolá metodu TryReadSessionTokenFromCookie pro čtení SessionSecurityToken ze souboru cookie relace, pokud je k dispozici.

2. Pokud token zabezpečení relace nelze přečíst (pravděpodobně proto, že relace nebyla vytvořena), vraťte ji.

3. Vyvolá metodu OnSessionSecurityTokenReceived pro vyvolání SessionSecurityTokenReceived události. To poskytuje příležitost ke změně tokenu přečteného ze souboru cookie nebo ke zrušení požadavku. Obslužná rutina může také určit, že token se má znovu vystavovat nastavením SessionSecurityTokenReceivedEventArgs.ReissueCookie vlastnosti .

4. Pokud se má token znovu vytvořit, odebere ho z mezipaměti a vyvolá metodu OnSessionSecurityTokenCreated pro vyvolání SessionSecurityTokenCreated události. To poskytuje příležitost k opětovné úpravě tokenu. Chování opakovaného spuštění lze také upravit nastavením SessionSecurityTokenCreatedEventArgs.WriteSessionCookie vlastnosti v obslužné rutině události.

5. Vyvolá metodu AuthenticateSessionSecurityToken pro ověření uživatele. V případě úspěchu to má za následek nastavení Thread.CurrentPrincipal vlastnosti na objekt zabezpečení, který je součástí SessionSecurityToken.ClaimsPrincipal vlastnosti příchozího tokenu.

6. Pokud platnost relace vypršela, vyvolá metodu SignOut .

Metoda OnAuthenticateRequest se přidá do obslužných rutin události HttpApplication.AuthenticateRequest v InitializeModule metodě .