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 a seguir mostra uma implementação da IssuerNameRegistry classe que aceita apenas emissores que usam certificados com a entidade "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.");
        }
    }
}

A seguir, mostra o XML necessário para configurar um aplicativo com o registro de nome do emissor confiável.

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

Comentários

O registro de nome do emissor é usado para associar um nome mnemônico ao material criptográfico necessário para verificar assinaturas de tokens produzidos pelo emissor correspondente. Esse nome é então usado para definir a Issuer propriedade ou OriginalIssuer de uma declaração. Os métodos expostos pela IssuerNameRegistry classe são chamados do pipeline pelo manipulador de token de segurança que está processando o token. Tokens assinados por material que não é mapeado por um registro de nome do emissor são descartados como não confiáveis. O nome retornado pelo registro de nome do emissor deve ser exclusivo dentro do contexto de um aplicativo RP.

No código, você pode especificar o registro de nome do emissor a ser usado definindo a SecurityTokenHandlerConfiguration.IssuerNameRegistry propriedade . Em um arquivo de configuração, o registro de nome do emissor pode ser especificado especificando o <elemento issuerNameRegistry> no <elemento securityTokenHandlerConfiguration> .

O WIF (Windows Identity Foundation) fornece uma implementação da IssuerNameRegistry classe pronta para uso: a ConfigurationBasedIssuerNameRegistry classe . Ao usar essa implementação, você pode especificar a lista de emissores confiáveis no arquivo de configuração do aplicativo RP no <elemento trustedIssuers> , que é um elemento filho do <issuerNameRegistry> elemento quando a ConfigurationBasedIssuerNameRegistryclasse .é referenciada no atributo desse type elemento. No elemento , cada nome do <trustedIssuers> emissor é mapeado para o certificado X.509 que deve ser usado para verificar sua assinatura.

Para criar um registro de nome de emissor personalizado, você deve substituir o IssuerNameRegistry.GetIssuerName(SecurityToken) método . Esse método retorna o nome do emissor para o token de segurança especificado. Opcionalmente, você pode substituir o IssuerNameRegistry.GetIssuerName(SecurityToken, String) método para fornecer um mecanismo de dica ao recuperar nomes de emissor e o GetWindowsIssuerName método se quiser fornecer um nome de emissor para tokens do Windows diferentes de DefaultIssuer. Substitua o método para permitir que o LoadCustomConfiguration registro de nome do emissor seja inicializado de um arquivo de configuração.

Construtores

Métodos

Aplica-se a

Confira também

• ConfigurationBasedIssuerNameRegistry
• SecurityTokenHandler
• <issuerNameRegistry>