View a markdown version of this page

Générez des clés asymétriques à l'aide de la CLI CloudHSM - AWS CloudHSM

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.

Générez des clés asymétriques à l'aide de la CLI CloudHSM

Utilisez les commandes répertoriées dans La catégorie de génération de paires asymétriques dans la CLI CloudHSM pour générer des paires de clés asymétriques pour les AWS CloudHSM clusters.

Générer une clé RSA

Utilisez la commande key generate-asymmetric-pair rsa pour générer une paire de clés RSA. Pour consulter toutes les options disponibles, utilisez la commande help key generate-asymmetric-pair rsa.

Exemple

L'exemple suivant génère une paire de clés RSA 2048 bits.

aws-cloudhsm > key generate-asymmetric-pair rsa \ --public-exponent 65537 \ --modulus-size-bits 2048 \ --public-label rsa-public-example \ --private-label rsa-private-example

Arguments

<PUBLIC_LABEL>

Spécifie une étiquette définie par l'utilisateur pour la clé publique.

Obligatoire : oui

<PRIVATE_LABEL>

Spécifie l'étiquette définie par l'utilisateur pour la clé privée.

Obligatoire : oui

<MODULUS_SIZE_BITS>

Indique la longueur du module en bits. La valeur minimale est de 2048.

Obligatoire : oui

<PUBLIC_EXPONENT>

Spécifie l' exposant public. La valeur doit être un entier impair supérieur ou égal à 65 537.

Obligatoire : oui

<PUBLIC_KEY_ATTRIBUTES>

Spécifie une liste séparée par des espaces d'attributs de clés à définir pour la clé publique RSA générée sous la forme KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE (par exemple, sign=true).

Pour obtenir la liste des attributs AWS CloudHSM clés pris en charge, consultezAttributs de clé de la CLI CloudHSM.

Obligatoire : non

<SESSION>

Crée une clé qui existe uniquement dans la session en cours. La clé ne peut pas être récupérée une fois la session terminée. Utilisez ce paramètre lorsque vous n'avez besoin que brièvement d'une clé, par exemple une clé d'encapsulage qui chiffre, puis déchiffre rapidement, une autre clé. N'utilisez pas de clé de session pour chiffrer les données que vous pourriez avoir besoin de déchiffrer après la fin de la session.

Pour remplacer une clé de session par une clé persistante (jeton), utilisez key set-attribute.

Par défaut, lorsque les clés sont générées, elles sont persistent/token des clés. En utilisant <SESSION>ces modifications, vous vous assurez qu'une clé générée avec cet argument est une session/ephemeral

Obligatoire : non

Générez des paires de clés EC (Elliptic Curve Cryptography)

Utilisez la commande key generate-asymmetric-pair ec pour générer une paire de clés EC. Pour voir toutes les options disponibles, notamment une liste des courbes elliptiques prises en charge, utilisez la commande help key generate-asymmetric-pair ec.

Exemple

L'exemple suivant génère une paire de clés EC à l'aide de la courbe elliptique Secp384r1.

aws-cloudhsm > key generate-asymmetric-pair ec \ --curve secp384r1 \ --public-label ec-public-example \ --private-label ec-private-example

Arguments

<PUBLIC_LABEL>

Spécifie une étiquette définie par l'utilisateur pour la clé publique. La taille maximale autorisée label est de 127 caractères pour le SDK client 5.11 et les versions ultérieures. Le SDK client 5.10 et versions antérieures est limité à 126 caractères.

Obligatoire : oui

<PRIVATE_LABEL>

Spécifie l'étiquette définie par l'utilisateur pour la clé privée. La taille maximale autorisée label est de 127 caractères pour le SDK client 5.11 et les versions ultérieures. Le SDK client 5.10 et versions antérieures est limité à 126 caractères.

Obligatoire : oui

<CURVE>

Spécifie l'identifiant de la courbe elliptique.

Valeurs valides :

  • prime256v1

  • secp256r1

  • secp224r1

  • secp384r1

  • secp256k1

  • secp521r1

  • ed25519 (uniquement pris en charge sur les instances hsm2m.medium en mode non FIPS)

Obligatoire : oui

<PUBLIC_KEY_ATTRIBUTES>

Spécifie une liste séparée par des espaces d'attributs de clés à définir pour la clé publique EC générée sous la forme KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE (par exemple, verify=true).

Pour obtenir la liste des attributs AWS CloudHSM clés pris en charge, consultezAttributs de clé de la CLI CloudHSM.

Obligatoire : non

<PRIVATE_KEY_ATTRIBUTES>

Spécifie une liste séparée par des espaces d'attributs de clés à définir pour la clé privée EC générée sous la forme KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE (par exemple, sign=true).

Pour obtenir la liste des attributs AWS CloudHSM clés pris en charge, consultezAttributs de clé de la CLI CloudHSM.

Obligatoire : non

<SESSION>

Crée une clé qui existe uniquement dans la session en cours. La clé ne peut pas être récupérée une fois la session terminée. Utilisez ce paramètre lorsque vous n'avez besoin que brièvement d'une clé, par exemple une clé d'encapsulage qui chiffre, puis déchiffre rapidement, une autre clé. N'utilisez pas de clé de session pour chiffrer les données que vous pourriez avoir besoin de déchiffrer après la fin de la session.

Pour remplacer une clé de session par une clé persistante (jeton), utilisez key set-attribute.

Par défaut, les clés générées sont des clés persistantes (jetons). La transmission vers <SESSION> change cela, garantissant qu'une clé générée avec cet argument est une clé de session (éphémère).

Obligatoire : non

Générer des paires de ML-DSA clés

Utilisez la key generate-asymmetric-pair ml-dsa commande pour générer une paire de ML-DSA clés. Pour consulter toutes les options disponibles, utilisez la commande help key generate-asymmetric-pair ml-dsa.

Exemple

L'exemple suivant génère une paire de ML-DSA clés à l'aide de l' ML-DSA-44 algorithme.

aws-cloudhsm > key generate-asymmetric-pair ml-dsa \ --mldsa-algorithm ML-DSA-44 \ --public-label ml-dsa-public-example \ --private-label ml-dsa-private-example

Arguments

<PUBLIC_LABEL>

Spécifie une étiquette définie par l'utilisateur pour la clé publique.

Obligatoire : oui

<PRIVATE_LABEL>

Spécifie l'étiquette définie par l'utilisateur pour la clé privée.

Obligatoire : oui

<MLDSA_ALGORITHM>

Spécifie l' ML-DSA algorithme.

Valeurs valides :

  • ML-DSA-44

  • ML-DSA-65

  • ML-DSA-87

Obligatoire : oui