SecurityTokenHandler.CreateToken(SecurityTokenDescriptor) 方法

定义

命名空间:

System.IdentityModel.Tokens

程序集:

System.IdentityModel.dll

在派生类中重写时，使用指定的标记描述符创建新的安全标记。 通过安全标记服务 (STS) 调用此方法。

public:
 virtual System::IdentityModel::Tokens::SecurityToken ^ CreateToken(System::IdentityModel::Tokens::SecurityTokenDescriptor ^ tokenDescriptor);

public virtual System.IdentityModel.Tokens.SecurityToken CreateToken (System.IdentityModel.Tokens.SecurityTokenDescriptor tokenDescriptor);

abstract member CreateToken : System.IdentityModel.Tokens.SecurityTokenDescriptor -> System.IdentityModel.Tokens.SecurityToken
override this.CreateToken : System.IdentityModel.Tokens.SecurityTokenDescriptor -> System.IdentityModel.Tokens.SecurityToken

Public Overridable Function CreateToken (tokenDescriptor As SecurityTokenDescriptor) As SecurityToken

参数

tokenDescriptor

SecurityTokenDescriptor

令牌从其生成的安全令牌说明符。 在调用该方法之前设置标记说明符的属性。

返回

SecurityToken

与标记说明符属性匹配的安全标记。

示例

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

public override SecurityToken CreateToken(SecurityTokenDescriptor tokenDescriptor)
{
    if (tokenDescriptor == null)
    {
        throw new ArgumentNullException("tokenDescriptor");
    }

    NameValueCollection properties = new NameValueCollection();
    properties.Add(SimpleWebTokenConstants.Id, Guid.NewGuid().ToString());
    properties.Add(SimpleWebTokenConstants.Issuer, tokenDescriptor.TokenIssuerName);
    properties.Add(SimpleWebTokenConstants.Audience, tokenDescriptor.AppliesToAddress);
    properties.Add(SimpleWebTokenConstants.ExpiresOn, SecondsFromSwtBaseTime(tokenDescriptor.Lifetime.Expires));
    properties.Add(SimpleWebTokenConstants.ValidFrom, SecondsFromSwtBaseTime(tokenDescriptor.Lifetime.Created));

    foreach (Claim claim in tokenDescriptor.Subject.Claims)
    {
        properties.Add(claim.Type, claim.Value);
    }

    SimpleWebToken token = new SimpleWebToken(properties);
    return token;
}

注解

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

从 类的 SecurityTokenService 实现调用。