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