SessionAuthenticationModule.SessionSecurityTokenCreated Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возникает при создании маркера безопасности сеанса.
public:
event EventHandler<System::IdentityModel::Services::SessionSecurityTokenCreatedEventArgs ^> ^ SessionSecurityTokenCreated;
public event EventHandler<System.IdentityModel.Services.SessionSecurityTokenCreatedEventArgs> SessionSecurityTokenCreated;
member this.SessionSecurityTokenCreated : EventHandler<System.IdentityModel.Services.SessionSecurityTokenCreatedEventArgs>
Public Custom Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs)
Public Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs)
Тип события
Примеры
В следующем коде показан обработчик события SessionSecurityTokenCreated , реализованный в файле global.asax.cs веб-приложения ASP.NET. Необходимо также добавить обработчик в событие. Более полный пример показан в SessionAuthenticationModule разделе обзора.
void SessionAuthenticationModule_SessionSecurityTokenCreated(object sender, SessionSecurityTokenCreatedEventArgs e)
{
System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenCreated event");
//Store session on the server-side token cache instead writing the whole token to the cookie.
//It may improve throughput but introduces server affinity that may affect scalability
FederatedAuthentication.SessionAuthenticationModule.IsReferenceMode = true;
}
Комментарии
Это событие можно использовать для изменения маркера безопасности сеанса перед записью в файл cookie.
Событие SessionSecurityTokenCreated создается из OnAuthenticateRequest метода после создания маркера сеанса (SessionSecurityToken). Это происходит, например, если обработчик событий для SessionSecurityTokenReceived события изменяет маркер.
Это событие можно использовать для изменения свойств маркера сеанса, прежде чем он передается дальше по конвейеру и используется для проверки подлинности сущности, выполняя запрос (пользователь).
В обработчике событий можно получить доступ к маркеру SessionSecurityTokenCreatedEventArgs.SessionToken через свойство. После изменения маркера вы можете убедиться, что он записывается обратно в файл cookie, задав SessionSecurityTokenCreatedEventArgs.WriteSessionCookie для свойства значение true. В отличие от этого события, SessionSecurityTokenCreatedSessionSecurityTokenCreated не является отменяемым событием.