IssuerNameRegistry Classe

Definição

public ref class IssuerNameRegistry abstract : System::IdentityModel::Configuration::ICustomIdentityConfiguration

public abstract class IssuerNameRegistry : System.IdentityModel.Configuration.ICustomIdentityConfiguration

type IssuerNameRegistry = class
    interface ICustomIdentityConfiguration

Public MustInherit Class IssuerNameRegistry
Implements ICustomIdentityConfiguration

Herança

Object

IssuerNameRegistry

Derivado

System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry

Implementações

ICustomIdentityConfiguration

Exemplos

O código seguinte mostra uma implementação da IssuerNameRegistry classe que só aceita emissores que usam certificados com o sujeito "CN=localhost".

using System.IdentityModel.Tokens;

namespace System.IdentityModel.Samples
{
    /// <summary>
    /// This class verifies that the issuer is trusted, and provides the issuer name.
    /// </summary>
    public class TrustedIssuerNameRegistry : 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.");
        }
    }
}

O seguinte mostra o XML necessário para configurar uma aplicação com o registo de nomes do emissor de confiança.

<system.identityModel>
  <identityConfiguration>
    <issuerNameRegistry type="System.IdentityModel.Samples.TrustedIssuerNameRegistry, MyApp" />
  </identityConfiguration>
</system.identityModel>

Observações

O registo de nomes do emissor é usado para associar um nome mnemónico ao material criptográfico necessário para verificar as assinaturas dos tokens produzidos pelo emitente correspondente. Este nome é então usado para definir o Issuer ou a OriginalIssuer propriedade de uma reivindicação. Os métodos expostos pela IssuerNameRegistry classe são chamados do pipeline pelo gestor de token de segurança que está a processar o token. Tokens assinados por material que não está mapeado por um registo de nomes do emissor são descartados como não confiáveis. O nome devolvido pelo registo de nomes do emitente deve ser único no contexto de uma aplicação de RP.

No código, pode especificar o registo de nomes do emissor a usar definindo a SecurityTokenHandlerConfiguration.IssuerNameRegistry propriedade. Num ficheiro de configuração, o registo de nomes do emissor pode ser especificado especificando o <elemento IssuerNameRegistry> sob o <elemento securityTokenHandlerConfiguration> .

Windows Identity Foundation (WIF) fornece uma implementação da classe IssuerNameRegistry logo de uso: a classe ConfigurationBasedIssuerNameRegistry. Quando usa esta implementação, pode especificar a lista de emissores confiáveis no ficheiro de configuração da aplicação RP sob o <elemento trustedIssuers> , que é um elemento filho do <issuerNameRegistry> elemento quando o ConfigurationBasedIssuerNameRegistry.class é referenciado no atributo desse type elemento. Sob o <trustedIssuers> elemento, o nome de cada emissor é mapeado para o certificado X.509 que deve ser usado para verificar a sua assinatura.

Para criar um registo personalizado de nomes do emissor, deve sobrescrever o IssuerNameRegistry.GetIssuerName(SecurityToken) método. Este método devolve o nome do emissor para o token de segurança especificado. Pode, opcionalmente, sobrescrever o método IssuerNameRegistry.GetIssuerName(SecurityToken, String) para fornecer um mecanismo de hinting ao recuperar nomes dos emissores e o método GetWindowsIssuerName se quiser fornecer um nome de emissor para Windows tokens que seja diferente do DefaultIssuer. Substitua o LoadCustomConfiguration método para permitir que o registo de nomes do emissor seja inicializado a partir de um ficheiro de configuração.

Ver também

• ConfigurationBasedIssuerNameRegistry
• SecurityTokenHandler
• <emissorRegistoNomeNome>