SessionAuthenticationModule.SessionSecurityTokenReceived SessionAuthenticationModule.SessionSecurityTokenReceived SessionAuthenticationModule.SessionSecurityTokenReceived SessionAuthenticationModule.SessionSecurityTokenReceived Event

Definición

Se produce una vez leído un token de seguridad de la sesión de una cookie.Occurs when a session security token has been read from a 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) 

Ejemplos

En el código siguiente se muestra un controlador SessionSecurityTokenReceived para el evento implementado en el archivo global.asax.CS de una aplicación Web de ASP.net.The following code shows a handler for the SessionSecurityTokenReceived event implemented in the global.asax.cs file of an ASP.NET web application. También debe agregar el controlador al evento.You must also add the handler to the event. En el SessionAuthenticationModule tema de información general se muestra un ejemplo más completo.A more complete example is shown in the SessionAuthenticationModule overview topic.

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

Comentarios

El SessionSecurityTokenReceived evento se genera desde dentro del OnAuthenticateRequest método después de que se hayaSessionSecurityTokenleído correctamente un token de sesión () de la cookie de sesión.The SessionSecurityTokenReceived event is raised from within the OnAuthenticateRequest method after a session token (SessionSecurityToken) has been successfully read from the session cookie.

Puede usar este evento para modificar las propiedades del token de sesión antes de que se pasen a lo largo de la canalización y se usa para autenticar la entidad que realiza la solicitud (usuario).You can use this event to modify properties of the session token before it is passed further along the pipeline and is used to authenticate the entity making the request (user). Uno de los escenarios más comunes implica modificar la hora de expiración de la sesión ( SessionSecurityToken.ValidTo accesible a través de la propiedad) para invalidar la hora de lifetime expiración de la sesión establecida en la configuración mediante el atributo del < elemento> sessionTokenRequirement .One of the most common scenarios involves modifying the session expiration time (accessible through the SessionSecurityToken.ValidTo property) to override the session expiration time set in configuration through the lifetime attribute of the <sessionTokenRequirement> element. Al modificar esta propiedad en cada solicitud, puede implementar una sesión deslizante; es decir, una sesión en la que la duración se extiende cada vez que el usuario accede al sitio.By modifying this property on each request, you can implement a sliding session; that is, a session in which the lifetime is extended each time the user accesses the site.

En un controlador de eventos, puede acceder al token a través SessionSecurityTokenReceivedEventArgs.SessionToken de la propiedad.In an event handler, you can access the token through the SessionSecurityTokenReceivedEventArgs.SessionToken property. Después de modificar el token, puede asegurarse de que se vuelve a escribir en la cookie estableciendo el SessionSecurityTokenReceivedEventArgs.ReissueCookie en. trueAfter modifying the token, you can ensure that it is written back to the cookie by setting the SessionSecurityTokenReceivedEventArgs.ReissueCookie to true. Por último, SessionSecurityTokenReceived el evento es un evento cancelable, y puede establecer la Cancel propiedad de SessionSecurityTokenReceivedEventArgs para anular el procesamiento posterior de la solicitud.Finally, the SessionSecurityTokenReceived event is a cancelable event, and you can set the Cancel property of the SessionSecurityTokenReceivedEventArgs to abort further processing of the request.

Se aplica a