Pular para o conteúdo principal

Armazenamento de chaves via CNG

observação

Os repositórios de chaves CNG só são compatíveis com instalações em Windows Server.

A Cryptography API: Next Generation (CNG) trabalha com o armazenamento de chaves por meio de diversos Key Storage Providers (KSPs), que fazem de fato o trabalho de armazenar as chaves. Dispositivos como HSMs (Hardware Security Modules) e tokens criptográficos USB podem fornecer um KSP CNG que pode ser usado para se comunicar com o dispositivo.

Cada KSP CNG é identificado por um nome. Se estiver usando um HSM ou um token criptográfico, consulte a documentação do dispositivo para encontrar o nome do KSP. Veja também, na seção abaixo, os nomes de KSPs comuns.

Para configurar um repositório de chaves CNG no Amplia, use as seguintes configurações:

  • Type: CNG
  • ProviderName: nome que identifica o KSP a ser usado
  • UseMachineStore: alguns KSPs têm o conceito de armazenar as chaves no repositório do usuário (user store) ou no repositório da máquina (machine store) — o principal exemplo é o KSP nativo do sistema operacional. Por padrão, é usado o repositório do usuário. Defina esta configuração como true para usar o repositório da máquina.
  • Pin: o PIN do repositório, se necessário

Exemplo (arquivo de configuração .ini ou .conf):

[KeyStores:MyCngKeyStore]
Type=Cng
ProviderName=...

Exemplo (variáveis de ambiente):

KeyStores__MyCngKeyStore__Type=Cng
KeyStores__MyCngKeyStore__ProviderName=...

Exemplo (arquivo de configuração .json):

"KeyStores": {
...,
"MyCngKeyStore": {
"Type": "Cng",
"ProviderName": "..."
},
...
}

Repositórios de chaves CNG comuns​

Token criptográfico USB Safenet eToken:

"CngToken": {
"Type": "Cng",
"ProviderName": "SafeNet Smart Card Key Storage Provider"
}

Veja também​

Ver em Markdown