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.

# Importer une clé au format PEM à l'aide de la CLI CloudHSM
<a name="cloudhsm_cli-key-import-pem"></a>

Utilisez la **key import pem** commande AWS CloudHSM pour importer une clé au format PEM dans un module de sécurité matériel (HSM). Vous pouvez l'utiliser pour importer des clés publiques générées hors du HSM.

**Note**  
ML-DSA les clés ne peuvent pas être importées à l'aide de la **key import pem** commande. Pour utiliser des ML-DSA clés, générez-les directement sur le HSM à l'aide de [ key generate-asymmetric-pair ml-dsa. ](cloudhsm_cli-key-generate-asymmetric-pair-mldsa.md)

**Note**  
Utilisez la [Exporter une clé asymétrique à l'aide de la CLI CloudHSM](cloudhsm_cli-key-generate-file.md) commande pour créer un fichier PEM standard à partir d'une clé publique ou pour créer un fichier PEM de référence à partir d'une clé privée.

## Type utilisateur
<a name="cloudhsm_cli-key-import-pem-user-type"></a>

Les types d'utilisateur suivants peuvent exécuter cette commande.
+ Utilisateurs de chiffrement (CU)

## Exigences
<a name="cloudhsm_cli-key-import-pem-requirements"></a>
+ Pour exécuter cette commande, vous devez être connecté en tant que CU.

## Syntaxe
<a name="cloudhsm_cli-key-import-pem-syntax"></a>

```
aws-cloudhsm > help key import pem
Import key from a PEM file

Usage: key import pem [OPTIONS] --path {{<PATH>}} --label {{<LABEL>}} --key-type-class {{<KEY_TYPE_CLASS>}}
Options:
      --cluster-id {{<CLUSTER_ID>}}
          Unique Id to choose which of the clusters in the config file to run the operation against. If not provided, will fall back to the value provided when interactive mode was started, or error
      --path {{<PATH>}}
          Path where the key is located in PEM format
      --label {{<LABEL>}}
          Label for the imported key
      --key-type-class {{<KEY_TYPE_CLASS>}}
          Key type and class of the imported key [possible values: ec-public, rsa-public]
      --attributes [{{<IMPORT_KEY_ATTRIBUTES>}}...]
          Space separated list of key attributes in the form of KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE for the imported key
  -h, --help
          Print help
```

## Exemples
<a name="cloudhsm_cli-key-import-pem-examples"></a>

Cet exemple montre comment utiliser la **key import pem** commande pour importer une clé publique RSA à partir d'un fichier au format PEM.

**Example Exemple : importation d'une clé publique RSA**  

```
aws-cloudhsm > key import pem --path /home/example --label example-imported-key --key-type-class rsa-public
{
  "error_code": 0,
  "data": {
    "key": {
      "key-reference": "0x00000000001e08e3",
      "key-info": {
        "key-owners": [
          {
            "username": "cu1",                                   
            "key-coverage": "full"
          }
        ],
        "shared-users": [],
        "key-quorum-values": {
          "manage-key-quorum-value": 0,
          "use-key-quorum-value": 0
        },
        "cluster-coverage": "full"
      },
      "attributes": {
        "key-type": "rsa",
        "label": "example-imported-key",
        "id": "0x",
        "check-value": "0x99fe93",
        "class": "public-key",
        "encrypt": false,
        "decrypt": false,
        "token": true,
        "always-sensitive": false,
        "derive": false,
        "destroyable": true,
        "extractable": true,
        "local": false,
        "modifiable": true,
        "never-extractable": false,
        "private": true,
        "sensitive": false,
        "sign": false,
        "trusted": false,
        "unwrap": false,
        "verify": false,
        "wrap": false,
        "wrap-with-trusted": false,
        "key-length-bytes": 512,
        "public-exponent": "0x010001",
        "modulus": "0x8e9c172c37aa22ed1ce25f7c3a7c936dadc532201400128b044ebb4b96│··3e4930ab910df5a2896eaeb8853cfea0e341227654a8337a7864cc8a87d136f006cfba9e68d0b329│··746c1ad60941668b18699fc8169ff1ec363d0d18292845b2454d6a0b8c5d111b79c047619d460cdf│··be59debbacb66b7abeaf3f3d35dd2b9cfa6b6b7b1258b6866cb4085ac749e9d8552b3a4509e1b86c│··828cc794e22767b4f6b5bc6ff5c96f4b7e60eab305d669cfa2197e85379cb35c659bb58fcd246d48│··d9f6a7f36063b42da025459275aa8e3abedad775387086bd6c198ded868403f4b87ffda5a2d455ac│··aa6cbd00003c31d8d2f51d10cd272b31cf0c4037791f48ad51fb35",
        "modulus-size-bits": 2048
      }
    },
    "message": "Successfully imported key"
  }
}
```

**Example Exemple : importation d'une clé publique RSA avec des attributs facultatifs**  

```
aws-cloudhsm > key import pem --path /home/example --label example-imported-key-with-attributes --key-type-class rsa-public --attributes verify=true
{
  "error_code": 0,
  "data": {
    "key": {
      "key-reference": "0x00000000001e08e3",
      "key-info": {
        "key-owners": [
          {
            "username": "cu1",                                      
            "key-coverage": "full"
          }
        ],
        "shared-users": [],
        "key-quorum-values": {
          "manage-key-quorum-value": 0,
          "use-key-quorum-value": 0
        },
        "cluster-coverage": "full"
      },
      "attributes": {
        "key-type": "rsa",
        "label": "example-imported-key-with-attributes",
        "id": "0x",
        "check-value": "0x99fe93",
        "class": "public-key",
        "encrypt": false,
        "decrypt": false,
        "token": true,
        "always-sensitive": false,
        "derive": false,
        "destroyable": true,
        "extractable": true,
        "local": false,
        "modifiable": true,
        "never-extractable": false,
        "private": true,
        "sensitive": false,
        "sign": false,
        "trusted": false,
        "unwrap": false,
        "verify": true,
        "wrap": false,
        "wrap-with-trusted": false,
        "key-length-bytes": 512,
        "public-exponent": "0x010001",
        "modulus": "0x8e9c172c37aa22ed1ce25f7c3a7c936dadc532201400128b044ebb4b96│··3e4930ab910df5a2896eaeb8853cfea0e341227654a8337a7864cc8a87d136f006cfba9e68d0b329│··746c1ad60941668b18699fc8169ff1ec363d0d18292845b2454d6a0b8c5d111b79c047619d460cdf│··be59debbacb66b7abeaf3f3d35dd2b9cfa6b6b7b1258b6866cb4085ac749e9d8552b3a4509e1b86c│··828cc794e22767b4f6b5bc6ff5c96f4b7e60eab305d669cfa2197e85379cb35c659bb58fcd246d48│··d9f6a7f36063b42da025459275aa8e3abedad775387086bd6c198ded868403f4b87ffda5a2d455ac│··aa6cbd00003c31d8d2f51d10cd272b31cf0c4037791f48ad51fb35",
        "modulus-size-bits": 2048
      }
    },
    "message": "Successfully imported key"
  }
}
```

## Arguments
<a name="cloudhsm_cli-key-import-pem-arguments"></a>

**{{<CLUSTER\_ID>}}**  
L'ID du cluster sur lequel exécuter cette opération.  
Obligatoire : si plusieurs clusters ont été [ configurés. ](cloudhsm_cli-configs-multi-cluster.md)

**{{<PATH>}}**  
Spécifie le chemin du fichier où se trouve le fichier clé.  
Obligatoire : oui

**{{<LABEL>}}**  
Spécifie une étiquette définie par l'utilisateur pour la clé importée. La taille maximale autorisée pour `label` est de 126 caractères.  
Obligatoire : oui

**{{<KEY\_TYPE\_CLASS>}}**  
Type de clé et classe de clé encapsulée.  
Valeurs possibles :  
+ ec-public
+ rsa-public
Obligatoire : oui

**{{<IMPORT\_KEY\_ATTRIBUTES>}}**  
Spécifie une liste d'attributs clés séparés par des espaces à définir pour la clé importée sous la forme `KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE` (par exemple,`sign=true`). Pour obtenir la liste des attributs de clés pris en charge, consultez [Attributs de clé de la CLI CloudHSM](cloudhsm_cli-key-attributes.md).  
Obligatoire : non

## Rubriques associées
<a name="cloudhsm_cli-key-import-pem-seealso"></a>
+ [La catégorie des signes cryptographiques dans la CLI CloudHSM](cloudhsm_cli-crypto-sign.md)
+ [La catégorie Crypto Verify dans la CLI CloudHSM](cloudhsm_cli-crypto-verify.md)