SessionSecurityTokenCreatedEventArgs Class

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Namespace:   System.IdentityModel.Services
Assembly:  System.IdentityModel.Services (in System.IdentityModel.Services.dll)


public ref class SessionSecurityTokenCreatedEventArgs : EventArgs


Initializes a new instance of the SessionSecurityTokenCreatedEventArgs class by using the specified session security token.


Gets or sets the session security token that was created.


Gets or sets a value that indicates whether a cookie should be written in the response.


Determines whether the specified object is equal to the current object.(Inherited from Object.)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)


Serves as the default hash function. (Inherited from Object.)


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)


Returns a string that represents the current object.(Inherited from Object.)

By default:

  • In the session authentication module (SAM) the SessionSecurityTokenCreated event is raised from within the SessionAuthenticationModule::OnAuthenticateRequest method after a session token (SessionSecurityToken) has been created. This happens, for example, if an event handler for the SessionSecurityTokenReceived event modifies the token. You can use the SessionSecurityTokenCreatedEventArgs to modify the session token before it is passed further along the pipeline and is used to authenticate the entity making the request (user).

  • In the WS-Federation authentication module (WSFAM), the SessionSecurityTokenCreated event is raised from the request processing pipeline just after a session token has been created from the WS-Federation sign-in response message received from the STS and just before the SAM is called to set the thread principal and write the session cookie.

You can use the SessionToken property to modify or replace the token. You can set the WriteSessionCookie to specify whether the session cookie should be written (or re-written).

.NET Framework
Available since 4.5

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top