Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Installez le fournisseur JCE pour AWS CloudHSM SDK client 5
<a name="java-library-install_5"></a>

Le fournisseur JCE pour AWS CloudHSM Client SDK 5 est compatible avec OpenJDK 17, OpenJDK 21 et OpenJDK 25. Vous pouvez télécharger OpenJDK depuis le site Web d'[OpenJDK. ](https://openjdk.java.net/)

**Note**  
Le SDK client 5.17.0 est la dernière version à prendre en charge OpenJDK 8.
Le SDK client 5.17.1 est la dernière version à prendre en charge OpenJDK 11.

Utilisez les sections suivantes pour installer le fournisseur et lui fournir des informations d'identification.

**Note**  
Pour exécuter un seul cluster HSM avec le SDK client 5, vous devez d'abord gérer les paramètres de durabilité des clés client en définissant `disable_key_availability_check` sur `True`. Pour plus d'informations, veuillez consulter les sections [Synchronisation des clés](manage-key-sync.md) et [outil de configuration du SDK client 5](configure-sdk-5.md).

**Topics**
+ [Étape 1 : installer le fournisseur JCE](#install-java-library_5)
+ [Étape 2 : Fournissez les informations d'identification au fournisseur JCE](#java-library-credentials_5)

## Étape 1 : installer le fournisseur JCE
<a name="install-java-library_5"></a>

1. Utilisez les commandes suivantes pour télécharger et installer le fournisseur JCE. 

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

   Installez le fournisseur JCE pour Amazon Linux 2023 sur une architecture 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
   ```

   Installez le fournisseur JCE pour Amazon Linux 2023 sur l'architecture ARM64 :

   ```
   $ 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 ]

   Installez le fournisseur JCE pour Amazon Linux 2 sur une architecture 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
   ```

   Installez le fournisseur JCE pour Amazon Linux 2 sur l'architecture ARM64 :

   ```
   $ 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\+) ]

   Installez le fournisseur JCE pour RHEL 10 sur une architecture 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
   ```

   Installez le fournisseur JCE pour RHEL 10 sur l'architecture ARM64 :

   ```
   $ 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\+) ]

   Installez le fournisseur JCE pour RHEL 9 (9.2\+) sur une architecture 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
   ```

   Installez le fournisseur JCE pour RHEL 9 (9.2\+) sur l'architecture 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\+) ]

   Installez le fournisseur JCE pour RHEL 8 sur une architecture 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
   ```

   Installez le fournisseur JCE pour RHEL 8 sur l'architecture ARM64 :

   ```
   $ 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 26.04 LTS ]

   Installez le fournisseur JCE pour Ubuntu 26.04 LTS sur une architecture x86\_64 :

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

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

   Installez le fournisseur JCE pour Ubuntu 26.04 LTS sur l'architecture ARM64 :

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

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

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

   Installez le fournisseur JCE pour Ubuntu 24.04 LTS sur une architecture 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
   ```

   Installez le fournisseur JCE pour Ubuntu 24.04 LTS sur l'architecture 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 ]

   Installez le fournisseur JCE pour Ubuntu 22.04 LTS sur une architecture 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
   ```

   Installez le fournisseur JCE pour Ubuntu 22.04 LTS sur l'architecture 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 ]

   Installez le fournisseur JCE pour Windows Server sur une architecture x86\_64, ouvrez-le en PowerShell tant qu'administrateur et exécutez la commande suivante :

   ```
   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. Démarrez le SDK client 5. Pour plus d'informations sur le démarrage, consultez [Amorcez le SDK client](cluster-connect.md#connect-how-to).

1. Recherchez les fichiers du fournisseur JCE suivants :

------
#### [ 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`

------

## Étape 2 : Fournissez les informations d'identification au fournisseur JCE
<a name="java-library-credentials_5"></a>

Les HSM doivent d’abord authentifier votre application Java avant que l'application ne puisse les utiliser. Les HSM authentifient une session en utilisant la méthode de connexion explicite ou implicite.

**Connexion explicite** : Cette méthode vous permet de fournir les informations d’identification AWS CloudHSM directement dans l’application. Elle utilise la méthode [`AuthProvider`](https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/security/AuthProvider.html), dans laquelle vous transmettez le nom d'utilisateur et le mot de passe du CU dans le modèle d’accès. Pour plus d'informations, consultez la section [Connexion à un exemple de code HSM](https://github.com/aws-samples/aws-cloudhsm-jce-examples/blob/sdk5/src/main/java/com/amazonaws/cloudhsm/examples/LoginRunner.java).

**Connexion implicite** : Cette méthode vous permet de définir les informations de connexion AWS CloudHSM dans un nouveau fichier de propriétés, dans les propriétés système ou en tant que variables d’environnement.
+ **Propriétés système** : Définissez les informations d’identification par le biais des propriétés système lors de l’exécution de votre application. Les exemples suivants montrent deux manières de le faire :

------
#### [ 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>}}");
  ```

------
+ **Variables d’environnement** : Définissez les informations d’identification en tant que variables d’environnement.
**Note**  
Lorsque vous définissez des variables d'environnement, vous devez échapper à tous les caractères spéciaux susceptibles d'être interprétés par votre 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>}}"
  ```

------

Les informations d'identification peuvent ne pas être disponibles si l'application ne les fournit pas ou si vous essayez une opération avant que le HSM n’authentifie la session. Dans ces cas, la bibliothèque de logiciels CloudHSM pour Java recherche les informations d'identification dans l'ordre suivant :

1. Propriétés système

1. Variables d’environnement