SessionAuthenticationModule.OnAuthenticateRequest(Object, EventArgs) Metod

Definition

Namnområde:
System.IdentityModel.Services
Sammansättning:
System.IdentityModel.Services.dll

Hanterar händelsen AuthenticateRequest från ASP.NET pipeline.

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)

Parametrar

sender
Object

Källan för händelsen. Det här är ett HttpApplication objekt.

eventArgs
EventArgs

Data för händelsen.

Undantag

InvalidOperationException

Det finns ingen giltig sessionstokenhanterare konfigurerad. (Det finns ingen SessionSecurityTokenHandler konfigurerad i egenskapen SecurityTokenHandlers .)

Kommentarer

Den här metoden gör följande:

  1. Anropar TryReadSessionTokenFromCookie metoden för att läsa en SessionSecurityToken från sessionscookien, om en finns.

  2. Om en sessionssäkerhetstoken inte kan läsas (troligtvis eftersom en session inte har upprättats) returnerar du.

  3. Anropar OnSessionSecurityTokenReceived metoden för att skapa SessionSecurityTokenReceived händelsen. Detta ger en möjlighet att token som läss från cookien ändras eller att begäran avbryts. Hanteraren kan också ange att token ska återutfärdas genom att ange SessionSecurityTokenReceivedEventArgs.ReissueCookie egenskapen .

  4. Om token ska återutfärdas tar du bort den från cacheminnet och anropar OnSessionSecurityTokenCreated metoden för att skapa SessionSecurityTokenCreated händelsen. Detta ger möjlighet för token att ändras igen. Återgivningsbeteendet kan också ändras genom att ange SessionSecurityTokenCreatedEventArgs.WriteSessionCookie egenskapen i händelsehanteraren.

  5. Anropar metoden för att autentisera AuthenticateSessionSecurityToken användaren. Om det lyckas har detta effekten att ställa in Thread.CurrentPrincipal egenskapen på det huvudnamn som finns i egenskapen för den SessionSecurityToken.ClaimsPrincipal inkommande token.

  6. Om sessionen har upphört att gälla anropar du SignOut metoden.

Metoden OnAuthenticateRequest läggs till i hanterare för HttpApplication.AuthenticateRequest händelsen i InitializeModule -metoden.

Gäller för