SessionAuthenticationModule.OnAuthenticateRequest(Object, EventArgs) Metoda

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

Zpracovává AuthenticateRequest 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. HttpApplication Bude to objekt.

eventArgs

EventArgs

Data události.

Výjimky

InvalidOperationException

Není nakonfigurovaná 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 existuje.

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

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

4. Pokud se má token znovu spustit, 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í reissue 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á vliv na nastavení Thread.CurrentPrincipal vlastnosti na objekt zabezpečení, který je obsažen ve SessionSecurityToken.ClaimsPrincipal vlastnosti příchozího tokenu.

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

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