---
title: "Armazenamento de chaves via CNG"
description: "Repositório de chaves CNG do Amplia: uso de KSPs da Cryptography API: Next Generation para guardar chaves em HSMs e tokens, só em Windows Server."
canonical: "https://docs.lacunasoftware.com/articles/amplia/on-premises/key-stores/cng"
locale: "pt-BR"
product: "Amplia"
last_updated: "2026-10-08"
---

# 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*):

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

Exemplo (variáveis de ambiente):

```sh
KeyStores__MyCngKeyStore__Type=Cng
KeyStores__MyCngKeyStore__ProviderName=...
```

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

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

## Repositórios de chaves CNG comuns

Token criptográfico USB Safenet eToken:

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

## Veja também

* [Repositórios de chaves](https://docs.lacunasoftware.com/articles/amplia/on-premises/key-stores)
* [Amplia on-premises](https://docs.lacunasoftware.com/articles/amplia/on-premises)