SessionAuthenticationModule.SessionSecurityTokenCreated Evento

Definición

Espacio de nombres:

System.IdentityModel.Services

Ensamblado:

System.IdentityModel.Services.dll

Se produce cuando se ha creado un token de seguridad de la sesión.

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>

Ejemplos

El código siguiente muestra un controlador para el SessionSecurityTokenCreated evento implementado en el archivo global.asax.cs de una aplicación web ASP.NET. También debe agregar el controlador al evento . En el SessionAuthenticationModule tema de información general se muestra un ejemplo más completo.

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;
}

Comentarios

Puede usar este evento para modificar el token de seguridad de sesión antes de escribirlo en una cookie.

El SessionSecurityTokenCreated evento se genera desde dentro del OnAuthenticateRequest método después de crear un token de sesión (SessionSecurityToken). Esto sucede, por ejemplo, si un controlador de eventos para el SessionSecurityTokenReceived evento modifica el token.

Puede usar este evento para modificar las propiedades del token de sesión antes de pasarse más a lo largo de la canalización y se usa para autenticar la entidad que realiza la solicitud (usuario).

En un controlador de eventos, puede acceder al token a través de la SessionSecurityTokenCreatedEventArgs.SessionToken propiedad . Después de modificar el token, puede asegurarse de que se escribe en la cookie estableciendo la SessionSecurityTokenCreatedEventArgs.WriteSessionCookie propiedad trueen . A diferencia de esto, SessionSecurityTokenCreated el SessionSecurityTokenCreated evento no es un evento cancelable.