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á.

# Instale o provedor JCE para o AWS CloudHSM Client SDK 5
<a name="java-library-install_5"></a>

O provedor JCE para o AWS CloudHSM Client SDK 5 é compatível com o OpenJDK 17, o OpenJDK 21 e o OpenJDK 25. [Você pode baixar o OpenJDK no site do OpenJDK.](https://openjdk.java.net/)

**nota**  
O Client SDK 5.17.0 é a última versão compatível com o OpenJDK 8.
O Client SDK 5.17.1 é a última versão compatível com o OpenJDK 11.

Use as seções a seguir para instalar e fornecer credenciais ao provedor.

**nota**  
Para executar um único cluster HSM com o Client SDK 5, você deve primeiro gerenciar as configurações de durabilidade da chave do cliente configurando `disable_key_availability_check` como `True`. Para obter mais informações, consulte [Sincronização de chave](manage-key-sync.md) e a [ferramenta de configuração do Client SDK 5](configure-sdk-5.md).

**Topics**
+ [Etapa 1: instalar o provedor JCE](#install-java-library_5)
+ [Etapa 2: fornecer credenciais ao provedor JCE](#java-library-credentials_5)

## Etapa 1: instalar o provedor JCE
<a name="install-java-library_5"></a>

1. Use so seguintes comandos para fazer download e instalar o provedor JCE. 

------
#### [ Amazon Linux 2023 ]

   Instale o provedor JCE para Amazon Linux 2023 na arquitetura x86\_64:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Amzn2023/cloudhsm-jce-latest.amzn2023.x86_64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.amzn2023.x86_64.rpm
   ```

   Instale o provedor JCE para Amazon Linux 2023 na ARM64 arquitetura:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Amzn2023/cloudhsm-jce-latest.amzn2023.aarch64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.amzn2023.aarch64.rpm
   ```

------
#### [ Amazon Linux 2 ]

   Instale o provedor JCE para Amazon Linux 2 na arquitetura x86\_64:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-jce-latest.el7.x86_64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el7.x86_64.rpm
   ```

   Instale o provedor JCE para Amazon Linux 2 na ARM64 arquitetura:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL7/cloudhsm-jce-latest.el7.aarch64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el7.aarch64.rpm
   ```

------
#### [ RHEL 10 (10.0\+) ]

   Instale o provedor JCE para RHEL 10 na arquitetura x86\_64:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL10/cloudhsm-jce-latest.el10.x86_64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el10.x86_64.rpm
   ```

   Instale o provedor JCE para RHEL 10 na ARM64 arquitetura:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL10/cloudhsm-jce-latest.el10.aarch64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el10.aarch64.rpm
   ```

------
#### [ RHEL 9 (9.2\+) ]

   Instale o provedor JCE para RHEL 9 (9.2\+) na arquitetura x86\_64:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL9/cloudhsm-jce-latest.el9.x86_64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el9.x86_64.rpm
   ```

   Instale o provedor JCE para RHEL 9 (9.2\+) na arquitetura: ARM64 

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL9/cloudhsm-jce-latest.el9.aarch64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el9.aarch64.rpm
   ```

------
#### [ RHEL 8 (8.3\+) ]

   Instale o provedor JCE para RHEL 8 na arquitetura x86\_64:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL8/cloudhsm-jce-latest.el8.x86_64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el8.x86_64.rpm
   ```

   Instale o provedor JCE para RHEL 8 na ARM64 arquitetura:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/EL8/cloudhsm-jce-latest.el8.aarch64.rpm
   ```

   ```
   $ sudo yum install ./cloudhsm-jce-latest.el8.aarch64.rpm
   ```

------
#### [ Ubuntu 24.04 LTS ]

   Instale o provedor JCE para Ubuntu 24.04 LTS na arquitetura x86\_64:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Noble/cloudhsm-jce_latest_u24.04_amd64.deb
   ```

   ```
   $ sudo apt install ./cloudhsm-jce_latest_u24.04_amd64.deb
   ```

   Instale o provedor JCE para Ubuntu 24.04 LTS na arquitetura: ARM64 

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Noble/cloudhsm-jce_latest_u24.04_arm64.deb
   ```

   ```
   $ sudo apt install ./cloudhsm-jce_latest_u24.04_arm64.deb
   ```

------
#### [ Ubuntu 22.04 LTS ]

   Instale o provedor JCE para Ubuntu 22.04 LTS na arquitetura x86\_64:

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Jammy/cloudhsm-jce_latest_u22.04_amd64.deb
   ```

   ```
   $ sudo apt install ./cloudhsm-jce_latest_u22.04_amd64.deb
   ```

   Instale o provedor JCE para o Ubuntu 22.04 LTS na arquitetura: ARM64 

   ```
   $ wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Jammy/cloudhsm-jce_latest_u22.04_arm64.deb
   ```

   ```
   $ sudo apt install ./cloudhsm-jce_latest_u22.04_arm64.deb
   ```

------
#### [ Windows Server ]

   Instale o provedor JCE para Windows Server na arquitetura x86\_64, abra PowerShell como administrador e execute o seguinte comando:

   ```
   PS C:\> wget https://s3.amazonaws.com/cloudhsmv2-software/CloudHsmClient/Windows/AWSCloudHSMJCE-latest.msi -Outfile C:\AWSCloudHSMJCE-latest.msi
   ```

   ```
   PS C:\> Start-Process msiexec.exe -ArgumentList '/i C:\AWSCloudHSMJCE-latest.msi /quiet /norestart /log C:\client-install.txt' -Wait
   ```

------

1. Bootstrap do Client SDK 5. Para obter mais informações sobre ações de bootstrap, consulte [Bootstrap o Client SDK](cluster-connect.md#connect-how-to).

1. Localize os seguintes arquivos do provedor JCE:

------
#### [ Linux ]
   + `/opt/cloudhsm/java/cloudhsm-{{<version>}}.jar`
   + `/opt/cloudhsm/bin/configure-jce`
   + `/opt/cloudhsm/bin/jce-info`

------
#### [ Windows ]
   + `C:\Program Files\Amazon\CloudHSM\java\cloudhsm-{{<version>}}.jar>`
   + `C:\Program Files\Amazon\CloudHSM\bin\configure-jce.exe`
   + `C:\Program Files\Amazon\CloudHSM\bin\jce_info.exe`

------

## Etapa 2: fornecer credenciais ao provedor JCE
<a name="java-library-credentials_5"></a>

Antes que seu aplicativo Java possa usar um HSM, o HSM precisa primeiro autenticar o aplicativo. HSMs autentique usando um método de login explícito ou implícito.

**Login explícito** AWS CloudHSM esse método permite que você forneça credenciais do diretamente no aplicativo. Ele usa o método [https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/security/AuthProvider.html](https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/security/AuthProvider.html), em que você passa no mome do usuário, a senha e o ID da partição do HSM do usuário CU. Para obter mais informações, consulte [Exemplo de login em um código HSM](https://github.com/aws-samples/aws-cloudhsm-jce-examples/blob/sdk5/src/main/java/com/amazonaws/cloudhsm/examples/LoginRunner.java).

**Login implícito** AWS CloudHSM esse método permite que você defina as credenciais do em um novo arquivo de propriedades, as propriedades do sistema, ou como variáveis de ambiente.
+ **Propriedades do sistema**: defina as credenciais por meio das propriedades do sistema ao executar seu aplicativo. Os exemplos a seguir mostram duas formas diferentes de fazer isso:

------
#### [ Linux ]

  ```
  $ java -DHSM_USER={{<HSM user name>}} -DHSM_PASSWORD={{<password>}}
  ```

  ```
  System.setProperty("HSM_USER","{{<HSM user name>}}");
  System.setProperty("HSM_PASSWORD","{{<password>}}");
  ```

------
#### [ Windows ]

  ```
  PS C:\> java -DHSM_USER={{<HSM user name>}} -DHSM_PASSWORD={{<password>}}
  ```

  ```
  System.setProperty("HSM_USER","{{<HSM user name>}}");
  System.setProperty("HSM_PASSWORD","{{<password>}}");
  ```

------
+ **Variáveis de ambiente**: defina as credenciais como variáveis de ambiente.
**nota**  
Ao definir variáveis de ambiente, você deve escapar de quaisquer caracteres especiais que possam ser interpretados pelo seu shell.

------
#### [ Linux ]

  ```
  $ export HSM_USER={{<HSM user name>}}
  $ export HSM_PASSWORD={{<password>}}
  ```

------
#### [ Windows ]

  ```
  PS C:\> $Env:HSM_USER="{{<HSM user name>}}"
  PS C:\> $Env:HSM_PASSWORD="{{<password>}}"
  ```

------

As credenciais talvez não estejam disponíveis se o aplicativo não fornecê-las ou se você tentar uma operação antes que o HSM autentique a sessão. Nesses casos, a biblioteca de software do CloudHSM para Java procura as credenciais na seguinte ordem:

1. Propriedades do sistema

1. Variáveis de ambiente