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 格式和从 Cookie 格式序列化令牌。 默认情况下， 类将标记序列化为 WS-Secure Conversation Feb2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素。 (WSFAM) 和SessionAuthenticationModule (SAM) 使用WSFederationAuthenticationModule会话令牌来存储有关会话的信息，这主要是ClaimsPrincipal与经过身份验证的用户以及会话开始和过期时间相关联的。

在被动方案中， WSFederationAuthenticationModule 从身份验证管道调用 SessionAuthenticationModule (SAM) ，以从 ClaimsPrincipal 表示经过身份验证的用户的 创建会话令牌。 SAM 使用其配置 SessionSecurityTokenHandler 来创建令牌并将其序列化为 cookie (，并在后续请求) 从 Cookie 反序列化令牌。 SAM 使用其配置 CookieHandler 类的实例将 Cookie 写回到 HTTP 响应。 然后，此 Cookie 将返回到客户端，在后续请求中，客户端可以提供 Cookie，而不是往返于标识提供者以重新获取安全令牌。 有关会话如何使用 WIF 运行的详细信息，请参阅 WIF 会话管理。

如果会话令牌处于引用模式，即其 SessionSecurityToken.IsReferenceMode 属性为 true，则会话令牌处理程序仅序列化在 中 SessionSecurityTokenCache重新生成其密钥所需的会话令牌的属性。 在默认情况下， SessionSecurityTokenCacheKey 类用于表示缓存键，令牌处理程序写入 SessionSecurityToken.ContextId 令牌的 和 SessionSecurityToken.KeyGeneration 属性。 如果会话令牌不处于引用模式，即 SessionSecurityToken.IsReferenceMode 属性为 false，则除了前面提到的属性外，处理程序还会对从令牌序列化的字节数组调用 ApplyTransforms 方法，并将生成的值存储在 Cookie 中。 有关如何序列化令牌的详细信息，请参阅 SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) 方法。

属性 Transforms 获取应用于 方法中的会话令牌的 ApplyTransforms 转换列表。 所有转换都派生自 CookieTransform 类。 在默认情况下， DeflateCookieTransform 将应用 和 ProtectedDataCookieTransform 。 ProtectedDataCookieTransform使用数据保护 API (DPAPI) 来保护 Cookie 材料。 DPAPI 使用特定于在其保护算法中运行它的计算机的密钥。 因此，默认会话令牌处理程序在 Web 场方案中不可用，因为在这种情况下，可能需要在另一台计算机上读取写入的令牌。 可以使用多种策略来规避此问题。 例如，你能够：

• 将默认值 SessionSecurityTokenHandler 替换为 MachineKeySessionSecurityTokenHandler。 MachineKeySessionSecurityTokenHandler使你能够在配置文件中的 ASP.NET <machineKey> 元素下指定签名和加密密钥。

• 在 global.asax.cs 文件中为 FederatedAuthentication.FederationConfigurationCreated 事件提供处理程序，并将默认会话令牌处理程序替换为具有转换列表（包括 RsaSignatureCookieTransform 和 ）的 RsaEncryptionCookieTransform实例SessionSecurityTokenHandler。 可以通过调用采用转换列表的构造函数之一来创建新实例。

• 从 CookieTransform 基类派生自定义转换，并使用上述方法将其包含在要应用的转换列表中。

• 从 SessionSecurityTokenHandler 派生自定义令牌处理程序，并实现你自己的机制。

有关在 Web 场方案中使用会话的详细信息，请参阅 WIF 和 Web 场。

SessionSecurityTokenHandler包含在默认令牌处理程序集合中;但是，可以通过先在 securityTokenHandlers> 元素下<指定 remove<> 元素以从集合中删除默认处理程序，然后使用 add> 元素添加自定义令牌处理程序，将其替换为自定义会话令牌处理程序<。 默认情况下，可以通过在 元素下包括 <sessionTokenRequirement> 元素来 <add> 指定默认令牌生存期。 可以设计一个自定义令牌处理程序，通过重写 LoadCustomConfiguration 方法提供处理这些元素的逻辑，在 元素下<add>获取自定义配置元素。

构造函数

字段

属性

方法

适用于

另请参阅

• SessionSecurityTokenCache
• SessionSecurityToken
• MachineKeySessionSecurityTokenHandler
• CookieTransform
• <sessionTokenRequirement>
• WIF 和 Web 场
• WIF 会话管理