Partilhar via

Mapeando nomes de algoritmos para classes de criptografia

  • Artigo

Nota

Este artigo é específico do .NET Framework. Ele não se aplica a implementações mais recentes do .NET, incluindo o .NET 6 e versões posteriores.

Há quatro maneiras pelas quais um desenvolvedor pode criar um objeto de criptografia usando o SDK do Windows:

  • Crie um objeto usando o novo operador.

  • Crie um objeto que implemente um algoritmo de criptografia específico chamando o método Create na classe abstrata para esse algoritmo.

  • Crie um objeto que implemente um algoritmo de criptografia específico chamando o CryptoConfig.CreateFromName método.

  • Crie um objeto que implemente uma classe de algoritmos criptográficos (como uma cifra de bloco simétrico) chamando o método Create na classe abstrata para esse tipo de algoritmo (como SymmetricAlgorithm).

Por exemplo, suponha que um desenvolvedor queira calcular o hash SHA1 de um conjunto de bytes. O System.Security.Cryptography namespace contém duas implementações do algoritmo SHA1, uma implementação puramente gerenciada e outra que encapsula CryptoAPI. O desenvolvedor pode optar por instanciar uma implementação SHA1 específica (como a SHA1Managed) chamando o novo operador. No entanto, se não importa qual classe o common language runtime carrega, desde que a classe implemente o algoritmo de hash SHA1, o desenvolvedor pode criar um objeto chamando o SHA1.Create método. Esse método chama System.Security.Cryptography.CryptoConfig.CreateFromName("System.Security.Cryptography.SHA1"), que deve retornar uma implementação do algoritmo de hash SHA1.

O desenvolvedor também pode chamar System.Security.Cryptography.CryptoConfig.CreateFromName("SHA1") porque, por padrão, a configuração de criptografia inclui nomes curtos para os algoritmos fornecidos no .NET Framework.

Se não importa qual algoritmo de hash é usado, o desenvolvedor pode chamar o HashAlgorithm.Create método, que retorna um objeto que implementa uma transformação de hash.

Mapeando nomes de algoritmos em arquivos de configuração

Por padrão, o tempo de execução retorna um SHA1CryptoServiceProvider objeto para todos os quatro cenários. No entanto, um administrador de máquina pode alterar o tipo de objeto que os métodos nos dois últimos cenários retornam. Para fazer isso, você deve mapear um nome de algoritmo amigável para a classe que deseja usar no arquivo de configuração da máquina (Machine.config).

O exemplo a seguir mostra como configurar o tempo de execução para que System.Security.Cryptography.SHA1.Create, System.Security.CryptoConfig.CreateFromName("SHA1"), e System.Security.Cryptography.HashAlgorithm.Create retornem um MySHA1HashClass objeto. 

<configuration>
   <!-- Other configuration settings. -->
   <mscorlib>
      <cryptographySettings>
         <cryptoNameMapping>
            <cryptoClasses>
               <cryptoClass MySHA1Hash="MySHA1HashClass, MyAssembly
                  Culture='en', PublicKeyToken=a5d015c7d5a0b012,
                  Version=1.0.0.0"/>
            </cryptoClasses>
            <nameEntry name="SHA1" class="MySHA1Hash"/>
            <nameEntry name="System.Security.Cryptography.SHA1"
                       class="MySHA1Hash"/>
            <nameEntry name="System.Security.Cryptography.HashAlgorithm"
                       class="MySHA1Hash"/>
         </cryptoNameMapping>
      </cryptographySettings>
   </mscorlib>
</configuration>

Você pode especificar o nome do atributo no elemento cryptoClass> (o exemplo anterior nomeia o atributo MySHA1Hash).< O valor do atributo no <elemento cryptoClass> é uma cadeia de caracteres que o common language runtime usa para localizar a classe. Você pode usar qualquer cadeia de caracteres que atenda aos requisitos especificados em Especificando nomes de tipo totalmente qualificados.

Muitos nomes de algoritmos podem ser mapeados para a mesma classe. O <elemento nameEntry> mapeia uma classe para um nome de algoritmo amigável. O atributo name pode ser uma cadeia de caracteres usada ao chamar o método System.Security.Cryptography.CryptoConfig.CreateFromName ou o nome de uma classe de criptografia abstrata no System.Security.Cryptography namespace. O valor do atributo class é o nome do atributo no <elemento cryptoClass> .

Nota

Você pode obter um algoritmo SHA1 chamando o SHA1.Create ou o método Security.CryptoConfig.CreateFromName("SHA1"). Cada método garante apenas que retorna um objeto que implementa o algoritmo SHA1. Não é necessário mapear cada nome amigável de um algoritmo para a mesma classe no arquivo de configuração.

Para obter uma lista de nomes padrão e as classes mapeadas, consulte CryptoConfig.

Consulte também