SecurityTokenHandler.CreateSecurityTokenReference 方法

定义

在派生类中重写时,为该类处理的令牌创建安全令牌引用。 此方法通常由安全令牌服务(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

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

返回

引用指定令牌的密钥标识符子句。

示例

以下代码演示如何重写 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 消息的安全标头中不包含的安全令牌。 这些引用通常确认颁发的安全令牌的真实性。

适用于