SessionAuthenticationModule.SessionSecurityTokenReceived Событие

Определение

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

System.IdentityModel.Services

Сборка:

System.IdentityModel.Services.dll

Происходит при чтении маркера безопасности сеанса из файла cookie.

public:
 event EventHandler<System::IdentityModel::Services::SessionSecurityTokenReceivedEventArgs ^> ^ SessionSecurityTokenReceived;

public event EventHandler<System.IdentityModel.Services.SessionSecurityTokenReceivedEventArgs> SessionSecurityTokenReceived;

member this.SessionSecurityTokenReceived : EventHandler<System.IdentityModel.Services.SessionSecurityTokenReceivedEventArgs> 

Public Event SessionSecurityTokenReceived As EventHandler(Of SessionSecurityTokenReceivedEventArgs) 

Тип события

EventHandler<SessionSecurityTokenReceivedEventArgs>

Примеры

В следующем коде показан обработчик события SessionSecurityTokenReceived , реализованный в файле global.asax.cs веб-приложения ASP.NET. Необходимо также добавить обработчик в событие. Более полный пример показан в SessionAuthenticationModule разделе обзора.

void SessionAuthenticationModule_SessionSecurityTokenReceived(object sender, SessionSecurityTokenReceivedEventArgs e)
{
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenReceived event");
}

Комментарии

Событие SessionSecurityTokenReceived создается из OnAuthenticateRequest метода после успешного чтения маркера сеанса изSessionSecurityToken файла cookie сеанса.

Это событие можно использовать для изменения свойств маркера сеанса, прежде чем он передается дальше по конвейеру и используется для проверки подлинности сущности, выполняя запрос (пользователь). Одним из наиболее распространенных сценариев является изменение срока действия сеанса (доступное через SessionSecurityToken.ValidTo свойство), чтобы переопределить время окончания срока действия сеанса, заданное в конфигурации, с помощью lifetime атрибута <элемента sessionTokenRequirement> . Изменив это свойство по каждому запросу, можно реализовать скользящий сеанс; То есть сеанс, в течение которого время существования расширяется каждый раз, когда пользователь обращается к сайту.

В обработчике событий можно получить доступ к маркеру SessionSecurityTokenReceivedEventArgs.SessionToken через свойство. После изменения маркера можно убедиться, что он записывается обратно в файл cookie, задав SessionSecurityTokenReceivedEventArgs.ReissueCookie для него значение true. Наконец, SessionSecurityTokenReceived событие является отменяемым событием, и вы можете задать Cancel свойство SessionSecurityTokenReceivedEventArgs прерывания дальнейшей обработки запроса.