SecurityTokenHandler.CreateSecurityTokenReference 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在派生类中重写时,为该类处理的令牌创建安全令牌引用。 此方法通常由安全令牌服务(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 消息的安全标头中不包含的安全令牌。 这些引用通常确认颁发的安全令牌的真实性。