SecurityTokenHandler.CreateSecurityTokenReference 方法

定义

命名空间:

System.IdentityModel.Tokens

程序集:

System.IdentityModel.dll

当在派生类中重写，为该类处理的标记创建安全标记引用。 通常通过安全标记服务 (STS) 调用此方法。

public:
 virtual System::IdentityModel::Tokens::SecurityKeyIdentifierClause ^ CreateSecurityTokenReference(System::IdentityModel::Tokens::SecurityToken ^ token, bool attached);

public virtual System.IdentityModel.Tokens.SecurityKeyIdentifierClause CreateSecurityTokenReference (System.IdentityModel.Tokens.SecurityToken token, bool attached);

abstract member CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
override this.CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause

Public Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClause

参数

token

SecurityToken

创建引用的标记。

attached

Boolean

如果应创建附加引用，则为 true；如果应创建独立的引用，则为 false。

返回

SecurityKeyIdentifierClause

一个密钥标识符字句，该字句引用指定的令牌。

示例

以下代码演示如何重写 方法以 CreateSecurityTokenReference 从指定令牌创建密钥标识符子句。 代码取自示例 Custom Token 。 此示例提供自定义类，这些类支持处理简单 Web 令牌 (SWT) 。 有关此示例和可用于 WIF 的其他示例及其下载位置的信息，请参阅 WIF 代码示例索引。

public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
    return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();           
}

注解

默认情况下，此方法引发 NotImplementedException 异常。

派生类重写此方法，以返回密钥标识符子句 (SecurityKeyIdentifierClause) ，该子句可用于为指定标记创建 <wsse:SecurityTokenReference> 元素。

从 类的 SecurityTokenService 实现调用。

通常， SecurityKeyIdentifierClause 除了创建自定义安全令牌服务时，不需要使用 。 当安全令牌服务返回安全令牌时，已颁发的安全令牌包含对附加的和未附加的安全令牌的引用。 附加引用所引用的是包含在 SOAP 消息的安全标头中的安全令牌，而未附加引用则引用未包含在 SOAP 消息的安全标头中的安全令牌。 这些引用通常确认已颁发的安全令牌的真实性。