WSFederationAuthenticationModule.SessionSecurityTokenCreated イベント

定義

名前空間:

System.IdentityModel.Services

アセンブリ:

System.IdentityModel.Services.dll

セキュリティ トークン サービス (STS) から受け取ったセキュリティ トークンからセッション セキュリティ トークンが作成されたときに発生します。

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) 

イベントの種類

EventHandler<SessionSecurityTokenCreatedEventArgs>

例

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

注釈

イベント ハンドラーを追加してセッション トークンを変更してから、スレッド プリンシパルを設定し、セッション Cookie に書き込むことができます。 イベント ハンドラーでは、 プロパティを使用してセッション トークンに SessionSecurityTokenCreatedEventArgs.SessionToken アクセスできます。 セッション Cookie を書き込むかどうかを指定するには、 プロパティを SessionSecurityTokenCreatedEventArgs.WriteSessionCookie 設定します。

このイベントは、セキュリティ トークン サービス (STS) から受信したWS-Federationサインイン応答メッセージ ("wsignin1.0") を処理するときに、イベント ハンドラー デリゲート内 OnAuthenticateRequest から発生します。 これは、サインイン応答メッセージの wresult パラメーターまたは wresultptr パラメーターから逆シリアル化されたセキュリティ トークンが検証された直後、および 要求プリンシパルが に Thread.CurrentPrincipal 設定される直前に発生します (および User の HttpContext.Currentプロパティで)。

重要

参照モードでセッションを操作するには、global.asax.cs ファイルでイベントのWSFederationAuthenticationModule.SessionSecurityTokenCreatedハンドラーを提供し、 プロパティで渡されたトークンに プロパティをSessionSecurityTokenCreatedEventArgs.SessionToken設定SessionSecurityToken.IsReferenceModeすることをお勧めします。 これにより、セッション トークンがすべての要求に対して参照モードで動作し、単にセッション認証モジュールで プロパティを SessionAuthenticationModule.IsReferenceMode 設定するよりも優先されます。