IssuerNameRegistry.GetIssuerName Método

Definição

Namespace:

System.IdentityModel.Tokens

Assembly:

System.IdentityModel.dll

Quando substituído em uma classe derivada, retorna o nome de emissor para o token de segurança especificado.

Sobrecargas

GetIssuerName(SecurityToken)	Quando substituído em uma classe derivada, retorna o nome do emissor do token de segurança especificado.
GetIssuerName(SecurityToken, String)	Quando substituído em uma classe derivada, retorna o nome do emissor do token de segurança especificado. O nome de emissor especificado pode ser considerado para determinar o nome do emissor a ser retornado.

Comentários

Chamado do pipeline de processamento pelo manipulador de token de segurança que está processando o token. O método deve retornar um nome exclusivo para o emissor dentro do contexto do aplicativo RP.

GetIssuerName(SecurityToken)

Quando substituído em uma classe derivada, retorna o nome do emissor do token de segurança especificado.

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

Parâmetros

securityToken

SecurityToken

O token de segurança para o qual retornar o nome do emissor.

Retornos

String

O nome do emissor.

Exemplos

O código a seguir mostra o GetIssuerName método para um registro de nome do emissor. O exemplo completo está no tópico de visão geral da IssuerNameRegistry classe.

Aviso

O código a seguir é somente para fins ilustrativos. Validar certificados com base no nome da entidade não é uma boa prática. Esse código não deve ser usado como está em produção.

/// <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.");
}

Comentários

As implementações devem retornar uma cadeia de caracteres não nula e não vazia para identificar um emissor reconhecido ou uma cadeia de caracteres nula para identificar um emissor não reconhecido.

Chamado do pipeline de processamento pelo manipulador de token de segurança que está processando o token. O método deve retornar um nome exclusivo para o emissor dentro do contexto do aplicativo RP.

Confira também

• SecurityTokenHandler

GetIssuerName(SecurityToken, String)

Quando substituído em uma classe derivada, retorna o nome do emissor do token de segurança especificado. O nome de emissor especificado pode ser considerado para determinar o nome do emissor a ser retornado.

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

Parâmetros

securityToken

SecurityToken

O token de segurança para o qual retornar o nome do emissor.

requestedIssuerName

String

Um nome de emissor a ser considerado na solicitação.

Retornos

String

O nome do emissor.

Comentários

A implementação padrão ignora o requestedIssuerName parâmetro e simplesmente chama o IssuerNameRegistry.GetIssuerName(SecurityToken) método .

Chamado do pipeline de processamento pelo manipulador de token de segurança que está processando o token. O método deve retornar um nome exclusivo para o emissor dentro do contexto do aplicativo RP.

Confira também

• SecurityTokenHandler