As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Autentique-se no provedor de armazenamento de chaves (KSP) do AWS CloudHSM Client SDK 5
<a name="ksp-library-authentication"></a>

Antes de usar o provedor de armazenamento de chaves (KSP) para o AWS CloudHSM Client SDK 5, você deve definir as credenciais de login para o HSM em seu sistema. Você tem duas opções:
+ Gerenciador de credenciais do Windows (recomendado para maior segurança)
+ Variáveis de ambiente do sistema (configuração mais simples)

## Gerenciador de credenciais do Windows
<a name="sdk5-wcm"></a>

Você pode configurar as credenciais usando o utilitário `set_cloudhsm_credentials` ou a interface do Gerenciador de credenciais do Windows.
+ **Usar o utilitário `set_cloudhsm_credentials`**:

  O Windows Installer inclui o utilitário `set_cloudhsm_credentials`. É possível usar esse utilitário para passar convenientemente as credenciais de login do HSM para o Gerenciador de credenciais do Windows. Se desejar compilar esse utilitário da origem, use o código Python incluído no instalador.

  1. Acesse `C:\Program Files\Amazon\CloudHSM\tools\`.

  1. Execute este comando: .

     ```
     set_cloudhsm_credentials.exe --username {{<CU USER>}} --password {{<CU PASSWORD>}}
     ```
+ **Usar a interface do Gerenciador de credenciais**:

  1. Abra o Gerenciador de credenciais:
     + Insira `credential manager` na caixa de pesquisa da barra de tarefas 
     + Selecione **Gerenciador de credenciais**

  1. Selecione **Windows Credentials (Credenciais do Windows)** para gerenciar as credenciais do Windows.

  1. Selecione **Adicionar uma credencial genérica**

  1. Insira os detalhes a seguir:
     + **Endereço de internet ou de rede**: `CLOUDHSM_PIN`.
     + **Nome de usuário**:{{<CU USER>}}.
     + **Senha**:{{<CU PASSWORD>}}.

  1. Escolha **OK**

## Variáveis de ambiente do sistema
<a name="sdk5-enviorn-var"></a>

Você pode definir as variáveis de ambiente do sistema que identificam um HSM e um [usuário de criptografia](understanding-users.md#crypto-user-chsm-cli) (CU). 

**Atenção**  
A configuração de credenciais por meio de variáveis de ambiente do sistema armazena sua senha em texto simples no sistema. Para maior segurança, use o Gerenciador de credenciais do Windows em vez disso.

Você pode definir as variáveis de ambiente usando:
+ O [https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx).
+ O painel de controle **Propriedades do Sistema** (guia **Avançado**) do Windows.
+ definir métodos [Programáticos](https://msdn.microsoft.com/en-us/library/system.environment.setenvironmentvariable(v=vs.110).aspx) de variáveis de ambiente do sistema permanentes.

Para definir a variável de ambiente do sistema:

**`CLOUDHSM_PIN={{<CU USERNAME>}}:{{<CU PASSWORD>}}`**  
Identifica um [crypto user (usuário de criptografia)](understanding-users.md#crypto-user-chsm-cli) (CU) no HSM e fornece todas as informações de login necessárias. O aplicativo é autenticado e executado como esse CU. O aplicativo tem as permissões desse CU e pode visualizar e gerenciar apenas as chaves que o CU possui e compartilha. Para criar um usuário de criptografia, use o comando [user create](cloudhsm_cli-user-create.md) na CloudHSM CLI. Para encontrar os existentes CUs, use o comando [user list](cloudhsm_cli-user-list.md) na CLI do CloudHSM.  
Por exemplo:  

```
setx /m CLOUDHSM_PIN test_user:password123
```

**nota**  
Ao definir as variáveis de ambiente CLOUDHSM\_PIN, você deve escapar de quaisquer caracteres especiais que possam ser interpretados pelo seu shell.