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

如果应创建附加引用，则为 如果应创建未附加的引用，则为 。

返回

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 实现调用。

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