SessionAuthenticationModule.OnAuthenticateRequest(Object, EventArgs) Метод

Определение

Пространство имен:

System.IdentityModel.Services

Сборка:

System.IdentityModel.Services.dll

AuthenticateRequest Обрабатывает событие из конвейера 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)

Параметры

sender

Object

Источник события. Это будет HttpApplication объект.

eventArgs

EventArgs

Данные для события.

Исключения

InvalidOperationException

Не настроен допустимый обработчик маркера сеанса. (В свойстве SecurityTokenHandlers не SessionSecurityTokenHandler настроено.)

Комментарии

Этот метод выполняет следующие действия:

1. TryReadSessionTokenFromCookie Вызывает метод для чтения SessionSecurityToken из файла cookie сеанса, если он присутствует.

2. Если маркер безопасности сеанса не может быть прочитан (скорее всего, из-за того, что сеанс не установлен), возвращается.

3. OnSessionSecurityTokenReceived Вызывает метод для вызова SessionSecurityTokenReceived события. Это обеспечивает возможность изменения маркера из файла cookie или отмены запроса. Обработчик также может указать, что маркер должен быть переиздан, задав SessionSecurityTokenReceivedEventArgs.ReissueCookie свойство.

4. Если маркер должен быть переиздан, удаляет его из кэша и вызывает OnSessionSecurityTokenCreated метод для вызова SessionSecurityTokenCreated события. Это обеспечивает возможность повторного изменения маркера. Также можно изменить поведение повторного SessionSecurityTokenCreatedEventArgs.WriteSessionCookie просмотра, задав свойство в обработчике событий.

5. AuthenticateSessionSecurityToken Вызывает метод для проверки подлинности пользователя. В случае успешного выполнения это действие влияет на задание Thread.CurrentPrincipal свойства субъекту, содержащемуся в SessionSecurityToken.ClaimsPrincipal свойстве входящего маркера.

6. Если срок действия сеанса истек, вызывает SignOut метод.

Метод OnAuthenticateRequest добавляется в обработчики события HttpApplication.AuthenticateRequest в методе InitializeModule .