SessionSecurityTokenHandler.ReadToken 方法

定义

命名空间:

System.IdentityModel.Tokens

程序集:

System.IdentityModel.dll

读取 SessionSecurityToken。

重载

ReadToken(XmlReader)	使用指定的 XML 读取器读取 SessionSecurityToken。
ReadToken(Byte[], SecurityTokenResolver)	通过使用指定的标记解析器从字节流读取 SessionSecurityToken。
ReadToken(XmlReader, SecurityTokenResolver)	使用指定的 XML 读取器和标记解析程序读取 SessionSecurityToken。

注解

重要

使用不受信任的数据调用此方法存在安全风险。 仅使用受信任的数据调用此方法。 有关详细信息，请参阅 验证所有输入。

默认实现从 WS-Secure Conversation Feb2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素反序列化令牌。

ReadToken(XmlReader)

使用指定的 XML 读取器读取 SessionSecurityToken。

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader);

public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader);

override this.ReadToken : System.Xml.XmlReader -> System.IdentityModel.Tokens.SecurityToken

Public Overrides Function ReadToken (reader As XmlReader) As SecurityToken

参数

reader

XmlReader

在 XmlReader 上传入 SecurityToken。

返回

SecurityToken

读取的会话安全令牌，SessionSecurityToken 的一个实例。

例外

ArgumentNullException

reader 为 null。

SecurityTokenException

读取器不放置在 SessionSecurityToken 或 SessionSecurityToken 无法读取。

注解

重要

使用不受信任的数据调用此方法存在安全风险。 仅使用受信任的数据调用此方法。 有关详细信息，请参阅 验证所有输入。

阅读器必须定位在 WS-Secure Conversation Feb2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素上。

默认实现使用默认令牌解析程序调用 SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) 方法。

ReadToken(Byte[], SecurityTokenResolver)

通过使用指定的标记解析器从字节流读取 SessionSecurityToken。

public:
 virtual System::IdentityModel::Tokens::SecurityToken ^ ReadToken(cli::array <System::Byte> ^ token, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);

public virtual System.IdentityModel.Tokens.SecurityToken ReadToken (byte[] token, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);

override this.ReadToken : byte[] * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken

Public Overridable Function ReadToken (token As Byte(), tokenResolver As SecurityTokenResolver) As SecurityToken

参数

token

Byte[]

包含令牌的字节流。

tokenResolver

SecurityTokenResolver

要使用的令牌解析器。

返回

SecurityToken

读取的 SessionSecurityToken。

注解

重要

使用不受信任的数据调用此方法存在安全风险。 仅使用受信任的数据调用此方法。 有关详细信息，请参阅 验证所有输入。

默认实现通过 XmlDictionaryReader 令牌创建 并调用 SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) 方法。

ReadToken(XmlReader, SecurityTokenResolver)

使用指定的 XML 读取器和标记解析程序读取 SessionSecurityToken。

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);

public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);

override this.ReadToken : System.Xml.XmlReader * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken

Public Overrides Function ReadToken (reader As XmlReader, tokenResolver As SecurityTokenResolver) As SecurityToken

参数

reader

XmlReader

在 XmlReader 上传入 SecurityToken。

tokenResolver

SecurityTokenResolver

可用来解决 SecurityTokenResolver 的 SessionSecurityToken。

返回

SecurityToken

读取的会话安全令牌，SessionSecurityToken 的一个实例。

例外

ArgumentNullException

reader 为 null。

或

tokenResolver 为 null。

SecurityTokenException

读取器不放置在 SessionSecurityToken 或 SessionSecurityToken 无法读取。

注解

重要

使用不受信任的数据调用此方法存在安全风险。 仅使用受信任的数据调用此方法。 有关详细信息，请参阅 验证所有输入。

阅读器必须定位在 WS-Secure Conversation Feb2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素上。

如果缓存了令牌材料，则会从令牌缓存中读取，该缓存是 类的 SessionSecurityTokenCache 实例。 否则，将从 由 CookieElementName 和 CookieNamespace 属性指定的元素的<wsc:SecurityContextToken>子元素中读取令牌材料，ApplyTransforms并调用 方法来解码 Cookie。

有关如何将会话令牌序列化为 <SecurityContextToken 元素的详细信息，请参阅 SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) 方法。