SessionAuthenticationModule.SessionSecurityTokenCreated Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando um token de segurança de sessão é criado.
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) Tipo de Evento
Exemplos
O código seguinte mostra um handler para o evento SessionSecurityTokenCreated implementado no ficheiro global.asax.cs de uma aplicação web ASP.NET. Também deve adicionar o handler ao evento. Um exemplo mais completo é mostrado no SessionAuthenticationModule tópico de visão geral.
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;
}
Observações
Pode usar este evento para modificar o token de segurança da sessão antes de ser escrito num cookie.
O SessionSecurityTokenCreated evento é gerado dentro do OnAuthenticateRequest método após a criação de um token de sessão (SessionSecurityToken). Isto acontece, por exemplo, se um gestor de eventos do SessionSecurityTokenReceived evento modificar o token.
Pode usar este evento para modificar propriedades do token de sessão antes de este ser passado mais adiante no pipeline e ser usado para autenticar a entidade que faz o pedido (utilizador).
Num gestor de eventos, podes aceder ao token através da SessionSecurityTokenCreatedEventArgs.SessionToken propriedade. Após modificar o token, pode garantir que ele é escrito de volta no cookie definindo a SessionSecurityTokenCreatedEventArgs.WriteSessionCookie propriedade para true. Ao contrário do SessionSecurityTokenCreated evento, SessionSecurityTokenCreated não é um evento que pode ser cancelado.