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.
# AWS CloudHSM Exemples de configuration du SDK client 3
Ces exemples montrent comment utiliser l'**configure**outil pour le SDK AWS CloudHSM client 3.
**Example : Mettre à jour les données HSM pour le AWS CloudHSM client et key\_mgmt\_util**
Cet exemple utilise le `-a` paramètre de **configure** pour mettre à jour les données HSM pour le AWS CloudHSM client et key\_mgmt\_util. Pour utiliser le `-a` paramètre, vous devez disposer de l'adresse IP de l'un des éléments HSMs de votre cluster. Utilisez la console ou la CLI AWS pour obtenir l'adresse IP.
**Pour obtenir une adresse IP pour un HSM (console)**
1. Ouvrez la AWS CloudHSM console à la [https://console.aws.amazon.com/cloudhsm/maison](https://console.aws.amazon.com/cloudhsm/home).
1. Pour changer de région AWS, utilisez le Sélecteur de région dans l’angle supérieur droit de la page.
1. Pour ouvrir la page détaillée du cluster, choisissez l'ID du cluster dans le tableau des clusters.
1. Pour obtenir l'adresse IP, allez dans l' HSMs onglet. Pour les IPv4 clusters, choisissez une adresse répertoriée sous ** IPv4 adresse ENI**. Pour les clusters à double pile, utilisez l'adresse ENI IPv4 ou l'** IPv6 adresse ENI**.
**Pour obtenir une adresse IP pour un HSM ()AWS CLI**
+ Obtenez l'adresse IP d'un HSM à l'aide de la commande **[describe-clusters](https://docs.aws.amazon.com/cli/latest/reference/cloudhsmv2/describe-clusters.html)** d’ AWS CLI. Dans le résultat de la commande, l'adresse IP de HSMs sont les valeurs de `EniIp` et `EniIpV6` (s'il s'agit d'un cluster à double pile).
```
$ aws cloudhsmv2 describe-clusters
{
"Clusters": [
{ ... }
"Hsms": [
{
...
"EniIp": "10.0.0.9",
...
},
{
...
"EniIp": "10.0.1.6",
"EniIpV6": "2600:113f:404:be09:310e:ed34:3412:f733",
...
```
**Pour mettre à jour les données HSM**
1. Avant de mettre à jour le `-a` paramètre, arrêtez le AWS CloudHSM client. Ceci empêche les conflits qui peuvent se produire lorsque l'outil **configure** modifie le fichier de configuration du client. Si le client est déjà arrêté, cette commande n'a pas d'effet et vous pouvez l'utiliser dans un script.
------
#### [ Amazon Linux ]
```
$ sudo stop cloudhsm-client
```
------
#### [ Amazon Linux 2 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ CentOS 7 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ CentOS 8 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ RHEL 7 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ RHEL 8 ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ Ubuntu 16.04 LTS ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ Ubuntu 18.04 LTS ]
```
$ sudo service cloudhsm-client stop
```
------
#### [ Windows ]
+ Pour le Client Windows version 1.1.2 et ultérieure :
```
C:\Program Files\Amazon\CloudHSM>net.exe stop AWSCloudHSMClient
```
+ Pour les clients Windows version 1.1.1 et antérieure :
Utilisez **Ctrl** \+ **C** dans la fenêtre de commande dans laquelle vous avez démarré le AWS CloudHSM client.
------
1. Cette étape utilise le paramètre `-a`de l'outil **configure** pour ajouter l'adresse IP d'ENI `10.0.0.9` aux fichiers de configuration.
------
#### [ Amazon Linux ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Amazon Linux 2 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ CentOS 7 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ CentOS 8 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ RHEL 7 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ RHEL 8 ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Ubuntu 16.04 LTS ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Ubuntu 18.04 LTS ]
```
$ sudo /opt/cloudhsm/bin/configure -a 10.0.0.9
```
------
#### [ Windows ]
```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\configure.exe" -a 10.0.0.9
```
------
1. Ensuite, redémarrez le AWS CloudHSM client. Lorsque le client démarre, il utilise l'adresse IP d'ENI dans son fichier de configuration pour interroger le cluster. Ensuite, il écrit les adresses IP ENI de tous les membres du cluster HSMs dans le `cluster.info` fichier.
------
#### [ Amazon Linux ]
```
$ sudo start cloudhsm-client
```
------
#### [ Amazon Linux 2 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ CentOS 7 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ CentOS 8 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ RHEL 7 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ RHEL 8 ]
```
$ sudo service cloudhsm-client start
```
------
#### [ Ubuntu 16.04 LTS ]
```
$ sudo service cloudhsm-client start
```
------
#### [ Ubuntu 18.04 LTS ]
```
$ sudo service cloudhsm-client start
```
------
#### [ Windows ]
+ Pour le Client Windows version 1.1.2 et ultérieure :
```
C:\Program Files\Amazon\CloudHSM>net.exe start AWSCloudHSMClient
```
+ Pour les clients Windows version 1.1.1 et antérieure :
```
C:\Program Files\Amazon\CloudHSM>start "cloudhsm_client" cloudhsm_client.exe C:\ProgramData\Amazon\CloudHSM\data\cloudhsm_client.cfg
```
------
Lorsque la commande est terminée, les données HSM utilisées par le AWS CloudHSM client et key\_mgmt\_util sont complètes et exactes.
**Example : Mettre à jour des données HSM pour l’utilitaire CMU à partir du SDK client 3.2.1 et versions antérieures**
Cet exemple utilise la commande `-m` **configure** pour copier les données HSM mises à jour depuis le fichier `cluster.info` vers le fichier `cloudhsm_mgmt_util.cfg` utilisé par cloudhsm\_mgmt\_util. Utilisez-la avec l’utilitaire CMU fourni avec le SDK client 3.2.1 et versions antérieures.
+ Avant d'exécuter le`-m`, arrêtez le AWS CloudHSM client, exécutez la `-a` commande, puis redémarrez le AWS CloudHSM client, comme indiqué dans l'[exemple précédent](#configure-tool-examples). Cela garantit que les données copiées dans le fichier `cloudhsm_mgmt_util.cfg` depuis le fichier `cluster.info` sont complètes et précises.
------
#### [ Linux ]
```
$ sudo /opt/cloudhsm/bin/configure -m
```
------
#### [ Windows ]
```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\configure.exe" -m
```
------
**Example : Mettre à jour des données HSM pour l’utilitaire CMU à partir du SDK client 3.3.0 et versions ultérieures**
Cet exemple utilise le paramètre `--cmu` de la commande **configure** pour mettre à jour les données HSM pour l’utilitaire CMU. Utilisez-le avec l’utilitaire CMU fourni avec le SDK client 3.3.0 et versions ultérieures. Pour plus d'informations sur l'utilisation de l’utilitaire CMU, consultez les sections [Utilisation de l'Utilitaire de gestion CloudHSM (CMU) pour gérer les utilisateurs](manage-hsm-users-cmu.md) et [Utilisation de la CMU avec le SDK client 3.2.1 et versions antérieures](understand-users.md#downlevel-cmu).
+ Utilisez le paramètre `--cmu` pour transmettre l'adresse IP d'un HSM de votre cluster.
------
#### [ Linux ]
```
$ sudo /opt/cloudhsm/bin/configure --cmu {{}}
```
------
#### [ Windows ]
```
PS C:\> & "C:\Program Files\Amazon\CloudHSM\configure.exe" --cmu {{}}
```
------