SessionSecurityTokenHandler クラス

定義

public ref class SessionSecurityTokenHandler : System::IdentityModel::Tokens::SecurityTokenHandler

public class SessionSecurityTokenHandler : System.IdentityModel.Tokens.SecurityTokenHandler

type SessionSecurityTokenHandler = class
    inherit SecurityTokenHandler

Public Class SessionSecurityTokenHandler
Inherits SecurityTokenHandler

継承

Object

SecurityTokenHandler

SessionSecurityTokenHandler

派生

System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler

例

次の XML は、トークン ハンドラー コレクション内の既定のセッション セキュリティ トークン ハンドラーを構成の クラスのインスタンスに置き換える方法を MachineKeySessionSecurityTokenHandler 示しています。

<securityTokenHandlers>
  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</securityTokenHandlers>

注釈

クラスは SessionSecurityTokenHandler 、セッション トークンをシリアル化、逆シリアル化、検証します。 セッション トークンは、 型のトークンです SessionSecurityToken。 クラスは SessionSecurityTokenHandler 、Cookie 形式との間でトークンをシリアル化します。 既定では、クラスはトークンを WS-Secure Conversation Feb2005 または WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 要素にシリアル化します。 セッション トークンは、(WSFAM) と SessionAuthenticationModule (SAM) によってWSFederationAuthenticationModuleセッションに関する情報を格納するために使用されます。これは主に、認証されたユーザーとセッションの開始時刻と有効期限にClaimsPrincipal関連付けられています。

パッシブ シナリオでは、 WSFederationAuthenticationModule 認証パイプラインから (SAM) を SessionAuthenticationModule 呼び出して、認証されたユーザーを表す から ClaimsPrincipal セッション トークンを作成します。 SAM は、構成された SessionSecurityTokenHandler を使用してトークンを作成し、それを Cookie にシリアル化します (また、後続の要求で Cookie からトークンを逆シリアル化します)。 SAM は、構成された CookieHandler クラスのインスタンスを使用して、COOKIE を HTTP 応答に書き戻します。 その後、この Cookie はクライアントに返され、その後の要求で、クライアントは ID プロバイダーにラウンド トリップしてセキュリティ トークンを取得し直すのではなく、Cookie を提示できます。 WIF でのセッションの動作の詳細については、「 WIF セッション管理」を参照してください。

セッション トークンが参照モードの場合、つまり、その SessionSecurityToken.IsReferenceMode プロパティが である true場合、セッション トークン ハンドラーは、 で SessionSecurityTokenCacheキーを再生成するために必要なセッション トークンのプロパティのみをシリアル化します。 既定のケースでは、 クラスをSessionSecurityTokenCacheKey使用してキャッシュ キーを表し、トークン ハンドラーは トークンの プロパティと SessionSecurityToken.KeyGeneration プロパティを書き込SessionSecurityToken.ContextIdみます。 セッション トークンが参照モードでない場合、つまり SessionSecurityToken.IsReferenceMode 、 プロパティが である false場合、前に説明したプロパティに加えて、ハンドラーはトークンからシリアル化されたバイト配列で メソッドを呼び出 ApplyTransforms し、結果の値も Cookie に格納します。 トークンのシリアル化方法の詳細については、 メソッドを SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) 参照してください。

プロパティは Transforms 、 メソッドのセッション トークンに適用される変換の一覧を ApplyTransforms 取得します。 すべての変換は、 クラスから CookieTransform 派生します。 既定では、 DeflateCookieTransform と が ProtectedDataCookieTransform 適用されます。 では ProtectedDataCookieTransform 、Data Protection API (DPAPI) を使用して Cookie 素材を保護します。 DPAPI は、保護アルゴリズムで実行されているコンピューターに固有のキーを使用します。 このため、既定のセッション トークン ハンドラーは、Web ファームのシナリオでは使用できません。このようなシナリオでは、あるコンピューターに書き込まれたトークンを別のコンピューターで読み取る必要がある場合があるためです。 この問題を回避するには、多くの戦略を使用できます。 たとえば、次のように操作できます。

• 既定値 SessionSecurityTokenHandler を に MachineKeySessionSecurityTokenHandler置き換えます。 MachineKeySessionSecurityTokenHandlerでは、構成ファイルの ASP.NET <machineKey> 要素で署名キーと暗号化キーを指定できます。

• global.asax.cs ファイルで イベントのFederatedAuthentication.FederationConfigurationCreatedハンドラーを指定し、既定のセッション トークン ハンドラーを、 と を含むRsaSignatureCookieTransform変換のリストを持つ のインスタンスSessionSecurityTokenHandlerにRsaEncryptionCookieTransform置き換えます。 変換の一覧を受け取るコンストラクターのいずれかを呼び出すことで、新しいインスタンスを作成できます。

• 基底クラスからカスタム変換を CookieTransform 派生させ、上記の メソッドを使用して、適用する変換の一覧に含めます。

• からカスタム トークン ハンドラー SessionSecurityTokenHandler を派生させ、独自のメカニズムを実装します。

Web ファーム シナリオでのセッションの使用の詳細については、「 WIF および Web ファーム」を参照してください。

SessionSecurityTokenHandlerは既定のトークン ハンドラー コレクションに含まれていますが、まず securityTokenHandlers> 要素の下<に remove> 要素を指定してコレクションから既定のハンドラーを<削除し、add 要素を使用して<>カスタム トークン ハンドラーを追加することで、カスタム セッション トークン ハンドラーに置き換えることができます。 既定では、 要素の下に sessionTokenRequirement> 要素を<含めることで、既定のトークンの有効期間を<add>指定できます。 カスタム トークン ハンドラーを設計して、 要素の下でカスタム構成要素を <add> 取得するには、 LoadCustomConfiguration メソッドをオーバーライドして、それらを処理するロジックを提供します。

コンストラクター

フィールド

プロパティ

メソッド

適用対象

こちらもご覧ください

• SessionSecurityTokenCache
• SessionSecurityToken
• MachineKeySessionSecurityTokenHandler
• CookieTransform
• <sessionTokenRequirement>
• WIF および Web ファーム
• WIF セッション管理