IssuerNameRegistry.GetIssuerName 方法

定义

命名空间:

System.IdentityModel.Tokens

程序集:

System.IdentityModel.dll

当在派生类中重写时，返回指定安全令牌的颁发者名称。

重载

GetIssuerName(SecurityToken)	当在派生类中重写时，返回指定安全令牌的颁发者名称。
GetIssuerName(SecurityToken, String)	当在派生类中重写时，返回指定安全令牌的颁发者名称。 在确定要返回的颁布者名称中要考虑的指定的颁布者名称。

注解

由正在处理令牌的安全令牌处理程序从处理管道调用。 方法应在 RP 应用程序的上下文中返回颁发者的唯一名称。

GetIssuerName(SecurityToken)

当在派生类中重写时，返回指定安全令牌的颁发者名称。

public:
 abstract System::String ^ GetIssuerName(System::IdentityModel::Tokens::SecurityToken ^ securityToken);

public abstract string GetIssuerName (System.IdentityModel.Tokens.SecurityToken securityToken);

abstract member GetIssuerName : System.IdentityModel.Tokens.SecurityToken -> string

Public MustOverride Function GetIssuerName (securityToken As SecurityToken) As String

参数

securityToken

SecurityToken

返回颁布者名称的安全令牌。

返回

String

发行人名称。

示例

以下代码演示 GetIssuerName 颁发者名称注册表的 方法。 完整示例位于类概述主题中 IssuerNameRegistry 。

警告

以下代码仅用于说明目的。 基于使用者名称验证证书不是一种好的做法。 不应像在生产环境中那样使用此代码。

/// <summary>
/// Gets the issuer name of the given security token,
/// if it is the X509SecurityToken of 'localhost'.
/// </summary>
/// <param name="securityToken">The issuer's security token</param>
/// <returns>A string that represents the issuer name</returns>
/// <exception cref="SecurityTokenException">If the issuer is not trusted.</exception>
public override string GetIssuerName(SecurityToken securityToken)
{
    X509SecurityToken x509Token = securityToken as X509SecurityToken;
    if (x509Token != null)
    {
        if (String.Equals(x509Token.Certificate.SubjectName.Name, "CN=localhost"))
        {
            return x509Token.Certificate.SubjectName.Name;
        }
    }

    throw new SecurityTokenException("Untrusted issuer.");
}

注解

实现应返回一个非 null 和非空字符串来标识已识别的颁发者，或返回一个 null 字符串来标识无法识别的颁发者。

由正在处理令牌的安全令牌处理程序从处理管道调用。 方法应在 RP 应用程序的上下文中返回颁发者的唯一名称。

另请参阅

• SecurityTokenHandler

GetIssuerName(SecurityToken, String)

当在派生类中重写时，返回指定安全令牌的颁发者名称。 在确定要返回的颁布者名称中要考虑的指定的颁布者名称。

public:
 virtual System::String ^ GetIssuerName(System::IdentityModel::Tokens::SecurityToken ^ securityToken, System::String ^ requestedIssuerName);

public virtual string GetIssuerName (System.IdentityModel.Tokens.SecurityToken securityToken, string requestedIssuerName);

abstract member GetIssuerName : System.IdentityModel.Tokens.SecurityToken * string -> string
override this.GetIssuerName : System.IdentityModel.Tokens.SecurityToken * string -> string

Public Overridable Function GetIssuerName (securityToken As SecurityToken, requestedIssuerName As String) As String

参数

securityToken

SecurityToken

返回颁布者名称的安全令牌。

requestedIssuerName

String

要考虑请求的发行人名称。

返回

String

发行人名称。

注解

默认实现忽略 requestedIssuerName 参数，只需调用 IssuerNameRegistry.GetIssuerName(SecurityToken) 方法。

由正在处理令牌的安全令牌处理程序从处理管道调用。 方法应在 RP 应用程序的上下文中返回颁发者的唯一名称。

另请参阅

• SecurityTokenHandler