syncKey

Vous pouvez utiliser la commande syncKey dans cloudhsm_mgmt_util pour synchroniser manuellement des clés entre des instances HSM au sein d’un cluster ou entre des clusters clonés. En général, vous n'avez pas besoin d'utiliser cette commande, car les instances de HSM au sein d'un cluster synchronisent les clés automatiquement. Toutefois, la synchronisation de clés entre des clusters clonés doit être réalisée manuellement. Les clusters clonés sont généralement créés dans différentes AWS régions afin de simplifier les processus de mise à l'échelle mondiale et de reprise après sinistre.

Vous ne pouvez pas utiliser syncKey pour synchroniser des clés entre des clusters arbitraires : l'un des clusters doit avoir été créé à partir d'une sauvegarde de l'autre. En outre, les deux clusters doivent avoir des informations d'identification de CU et de CO cohérentes pour que l'opération réussisse. Pour plus d'informations, consultez Utilisateurs HSM.

Pour l'utilisersyncKey, vous devez d'abord créer un fichier de AWS CloudHSM configuration qui spécifie un HSM provenant du cluster source et un autre provenant du cluster de destination. Cela permet à cloudhsm_mgmt_util de se connecter aux deux instances HSM. Utilisez ce fichier de configuration pour démarrer cloudhsm_mgmt_util. Ensuite, connectez-vous avec les informations d'identification d'un CO ou d'un CU qui possède les clés à synchroniser.

Type utilisateur

Les types d'utilisateur suivants peuvent exécuter cette commande.

• Responsables de chiffrement (CO)

• Utilisateurs de chiffrement (CU)

Note

Les CO peuvent utiliser syncKey sur toutes les clés, tandis que les CU peuvent uniquement utiliser cette commande sur les clés qui leur appartiennent. Pour plus d’informations, consultez Comprendre les utilisateurs HSM.

Prérequis

Avant de commencer, vous devez connaître le key handle de la clé sur le HSM source à synchroniser avec le HSM de destination. Pour trouver le key handle, utilisez la commande listUsers pour répertorier tous les identifiants des utilisateurs nommés. Utilisez ensuite la findAllKeyscommande pour rechercher toutes les clés appartenant à un utilisateur en particulier.

Vous devez également connaître les server IDs affectés aux HSM source et de destination, qui sont affichés dans la sortie de suivi renvoyée par cloudhsm_mgmt_util au lancement. Ils sont attribués dans l'ordre d'affichage des HSM dans le fichier de configuration.

Suivez les instructions fournies dans la section Utilisation de l’utilitaire CMU entre des clusters clonés et initialisez cloudhsm_mgmt_util avec le nouveau fichier de configuration. Ensuite, activez le mode serveur sur le HSM source en exécutant la commande server.

Syntaxe

Note

Pour exécuter syncKey, commencez par activer le mode serveur sur le HSM qui contient la clé à synchroniser.

Comme cette commande n'a pas de paramètres nommés, vous devez entrer les arguments dans l'ordre spécifié dans le diagramme de syntaxe.

Type d'utilisateur : utilisateur de chiffrement

syncKey <key handle> <destination hsm>

Exemple

Exécutez la commande server pour vous connecter au HSM source et activez le mode serveur. Pour cet exemple, nous supposons que server 0 est le HSM source.

aws-cloudhsm> server 0

À présent, exécutez la commande syncKey. Dans cet exemple, nous supposons que la clé 261251 doit être synchronisée avec server 1.

aws-cloudhsm> syncKey 261251 1
syncKey success

Arguments

Comme cette commande n'a pas de paramètres nommés, vous devez entrer les arguments dans l'ordre spécifié dans le diagramme de syntaxe.

syncKey <key handle> <destination hsm>

<handle de clé>

Spécifie le handle de clé de la clé à synchroniser. Vous pouvez spécifier une seule clé dans chaque commande. Pour obtenir le descripteur d'une clé, utilisez-le findAllKeyslorsque vous êtes connecté à un serveur HSM.

Obligatoire : oui

<hsm de destination>

Spécifie le numéro du serveur avec lequel vous synchronisez une clé.

Obligatoire : oui

Rubriques en relation

• listUsers

• findAllKeys

• describe-clusters dans AWS CLI

• serveur