Consulte les paramètres utilisés pour importer du matériel de clé pour une clé principale client (CMK).
Description de l'opération
Les paramètres renvoyés peuvent être utilisés pour appeler l'opération ImportKeyMaterial.
Vous pouvez importer du matériel de clé uniquement pour les CMK dont le paramètre Origin est défini sur EXTERNAL.
La clé publique et le jeton renvoyés par l'opération GetParametersForImport doivent être utilisés ensemble. La clé publique et le jeton ne peuvent être utilisés pour importer du matériel de clé que pour la CMK spécifiée lors de l'appel de l'opération.
La clé publique et le jeton renvoyés varient à chaque appel de l'opération GetParametersForImport.
Vous devez spécifier le type de clé publique et l'algorithme de chiffrement utilisés pour chiffrer le matériel de clé. Le tableau suivant répertorie les types de clés publiques et les algorithmes de chiffrement autorisés pour chaque type.
| Type de clé publique | Algorithme de chiffrement | Description |
| RSA_2048 | RSAES_PKCS1_V1_5 |
RSAES_OAEP_SHA_1
RSAES_OAEP_SHA_256 | Les CMK de toutes les régions et de tous les niveaux de protection sont prises en charge.
Le service de gestion des clés (KMS) dédié ne prend pas en charge RSAES_OAEP_SHA_1. |
| EC_SM2 | SM2PKE | Les CMK dont le paramètre ProtectionLevel est défini sur HSM sont prises en charge. L'algorithme SM2 est développé et approuvé par l'Administration d'État de la cryptographie de Chine. L'algorithme SM2 ne peut être utilisé que pour importer du matériel de clé pour une CMK dont le paramètre ProtectionLevel est défini sur HSM. Vous ne pouvez utiliser l'algorithme SM2 que lorsque vous activez la fonctionnalité HSM géré pour KMS en Chine continentale. Pour plus d'informations, consultez Présentation de HSM géré. |
Pour plus d'informations, consultez Importer du matériel de clé. Cette rubrique fournit un exemple de requête des paramètres utilisés pour importer du matériel de clé pour une CMK. L'identifiant de la CMK est 1234abcd-12ab-34cd-56ef-12345678****, l'algorithme de chiffrement est RSAES_PKCS1_V1_5 et la clé publique est de type RSA_2048. Les paramètres renvoyés incluent l'identifiant de la CMK, la clé publique utilisée pour chiffrer le matériel de clé, le jeton utilisé pour importer le matériel de clé et l'heure d'expiration du jeton.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| KeyId |
string |
Oui |
L'identifiant globalement unique de la CMK. Remarque
Vous pouvez importer du matériel de clé uniquement pour les CMK dont le paramètre Origin est défini sur EXTERNAL. |
202b9877-5a25-46e3-a763-e20791b5**** |
| WrappingAlgorithm |
string |
Oui |
L'algorithme utilisé pour chiffrer le matériel de clé. |
RSAES_PKCS1_V1_5 |
| WrappingKeySpec |
string |
Oui |
Le type de clé publique utilisé pour chiffrer le matériel de clé. |
RSA_2048 |
Pour plus d'informations sur les paramètres de requête courants, consultez Paramètres courants.
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
|||
| KeyId |
string |
L'identifiant globalement unique de la CMK. La valeur de ce paramètre est requise lors de l'appel de l'opération ImportKeyMaterial. |
202b9877-5a25-46e3-a763-e20791b5**** |
| ImportToken |
string |
Le jeton utilisé pour importer le matériel de clé. Le jeton est valide pendant 24 heures. La valeur de ce paramètre est requise lors de l'appel de l'opération ImportKeyMaterial. |
Base64String |
| RequestId |
string |
L'identifiant de la requête, utilisé pour localiser et résoudre les problèmes. |
8cdf51fd-bcd6-d79a-0ef4-e52c9b5466dc |
| TokenExpireTime |
string |
L'heure d'expiration du jeton. |
2018-01-25T00:01:02Z |
| PublicKey |
string |
La clé publique utilisée pour chiffrer le matériel de clé. La clé publique est encodée en Base64. |
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlls4uIBxD0GG84C+lGBO6Dhpf1J3XimC6cPmPNaKKJMOzoX4tD+C+r7aZv8lZ3vnPfxuxvy/YwG+whUxTEEFUdqJTOIzhPfYucupqKM92crVHIuG+xtMVeHKjyTr+UrtKCsQikqHT+19yDRN/RMoo2HUx0gmEnRyXd8t3JyUXun9FdoxKA08GrsV7nodb9ZsoBLhnev7tTLcXvLyKW6XG1ZQCQm6dPnbnwLeDXR7uK0Lqn9PM28mBIdaiQUQxj2XbM1CoJA+JiyVX3Ptdb+4rqukb4Rb05B80Bs9xV/cf7FIku08l7xGhrGiQFq+DFXwQWtwihXHZxz3LhldU+4ZPwID**** |
Exemples
JSON format
{
"KeyId": "202b9877-5a25-46e3-a763-e20791b5****",
"ImportToken": "Base64String",
"RequestId": "8cdf51fd-bcd6-d79a-0ef4-e52c9b5466dc",
"TokenExpireTime": "2018-01-25T00:01:02Z",
"PublicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAlls4uIBxD0GG84C+lGBO6Dhpf1J3XimC6cPmPNaKKJMOzoX4tD+C+r7aZv8lZ3vnPfxuxvy/YwG+whUxTEEFUdqJTOIzhPfYucupqKM92crVHIuG+xtMVeHKjyTr+UrtKCsQikqHT+19yDRN/RMoo2HUx0gmEnRyXd8t3JyUXun9FdoxKA08GrsV7nodb9ZsoBLhnev7tTLcXvLyKW6XG1ZQCQm6dPnbnwLeDXR7uK0Lqn9PM28mBIdaiQUQxj2XbM1CoJA+JiyVX3Ptdb+4rqukb4Rb05B80Bs9xV/cf7FIku08l7xGhrGiQFq+DFXwQWtwihXHZxz3LhldU+4ZPwID****"
}Codes d'erreur
|
Code de statut HTTP |
Code d'erreur |
Message d'erreur |
Description |
|---|---|---|---|
| 400 | Unsupported.Origin | This key origin is not valid for this api | The key origin is not supported for this API operation. |
| 400 | InvalidParameter | The specified parameter is not valid. | An invalid value is specified for the parameter. |
| 404 | InvalidAccessKeyId.NotFound | The Access Key ID provided does not exist in our records. |
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.