WSFederationAuthenticationModule.SessionSecurityTokenCreated Ereignis

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Tritt ein, wenn ein Sitzungssicherheitstoken vom Sicherheitstoken erstellt wurde, der von einem Sicherheitstokendienst (STS) ausgegeben wird.

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) 

Ereignistyp

EventHandler<SessionSecurityTokenCreatedEventArgs>

Beispiele

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

Hinweise

Sie können einen Ereignishandler hinzufügen, um das Sitzungstoken zu ändern, bevor es zum Festlegen des Threadprinzipals verwendet wird und in das Sitzungscookies geschrieben wird. Im Ereignishandler können Sie über die -Eigenschaft auf das Sitzungstoken SessionSecurityTokenCreatedEventArgs.SessionToken zugreifen. Sie können angeben, ob ein Sitzungscookies geschrieben werden soll, indem Sie die SessionSecurityTokenCreatedEventArgs.WriteSessionCookie -Eigenschaft festlegen.

Dieses Ereignis wird innerhalb des OnAuthenticateRequest Ereignishandlerdelegaten ausgelöst, wenn eine vom Sicherheitstokendienst (STS) empfangene WS-Federation Anmeldeantwortmeldung ("wsignin1.0") verarbeitet wird. Sie wird unmittelbar nach dem Überprüfen des Sicherheitstokens ausgelöst, das aus dem wresult- oder dem wresultptr-Parameter in der Anmeldeantwortnachricht deserialisiert wurde, und bevor der Anspruchsprinzipal für ( Thread.CurrentPrincipal und für die User -Eigenschaft von HttpContext.Current) festgelegt wird.

Wichtig

Um Sitzungen im Verweismodus auszuführen, empfiehlt Microsoft, einen Handler für das WSFederationAuthenticationModule.SessionSecurityTokenCreated Ereignis in der Datei global.asax.cs bereitzustellen und die SessionSecurityToken.IsReferenceMode Eigenschaft für das token festzulegen, das in der SessionSecurityTokenCreatedEventArgs.SessionToken Eigenschaft übergeben wird. Dadurch wird sichergestellt, dass das Sitzungstoken für jede Anforderung im Verweismodus ausgeführt wird und gegenüber dem bloßen Festlegen der SessionAuthenticationModule.IsReferenceMode Eigenschaft im Sitzungsauthentifizierungsmodul bevorzugt wird.