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