WSFederationAuthenticationModule.SessionSecurityTokenCreated Evento

Definição

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Ocorre quando um token de segurança de sessão foi criado com base no token de segurança recebido de um STS (serviço de token de segurança).

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 Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs) 

Tipo de evento

EventHandler<SessionSecurityTokenCreatedEventArgs>

Exemplos

void WSFederationAuthenticationModule_SessionSecurityTokenCreated(object sender, SessionSecurityTokenCreatedEventArgs e)
{
    //Manipulate session token here, for example, changing its expiration value
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenCreated event");
    System.Diagnostics.Trace.WriteLine("Key valid from: " + e.SessionToken.KeyEffectiveTime);
    System.Diagnostics.Trace.WriteLine("Key expires on: " + e.SessionToken.KeyExpirationTime);
}

Comentários

Você pode adicionar um manipulador de eventos para modificar o token de sessão antes que ele seja usado para definir a entidade de thread e seja gravado no cookie de sessão. No manipulador de eventos, você pode acessar o token de sessão por meio da SessionSecurityTokenCreatedEventArgs.SessionToken propriedade . Você pode especificar se um cookie de sessão deve ser gravado definindo a SessionSecurityTokenCreatedEventArgs.WriteSessionCookie propriedade .

Esse evento é gerado de dentro do OnAuthenticateRequest delegado do manipulador de eventos ao processar um WS-Federation mensagem de resposta de entrada ("wsignin1.0") recebida do STS (serviço de token de segurança). Ele é gerado logo após o token de segurança que foi desserializado do wresult ou do parâmetro wresultptr na mensagem de resposta de entrada ter sido validado e antes que a entidade de segurança de declarações seja definida no Thread.CurrentPrincipal (e na User propriedade de HttpContext.Current).

Importante

Para operar sessões no modo de referência, a Microsoft recomenda fornecer um manipulador para o WSFederationAuthenticationModule.SessionSecurityTokenCreated evento no arquivo global.asax.cs e definir a SessionSecurityToken.IsReferenceMode propriedade no token passado na SessionSecurityTokenCreatedEventArgs.SessionToken propriedade . Isso garantirá que o token de sessão opere no modo de referência para cada solicitação e seja favorecido em vez de simplesmente definir a SessionAuthenticationModule.IsReferenceMode propriedade no Módulo de Autenticação de Sessão.