ExportDataKey - - Centre de documentation Alibaba Cloud

Description de l'opération

Précautions

Pour plus d'informations sur la stratégie d'accès requise pour qu'un utilisateur RAM ou un rôle RAM puisse utiliser cette opération, consultez Resource Access Management.
Cette opération est accessible via une passerelle partagée ou une passerelle dédiée. Pour plus d'informations, consultez Alibaba Cloud SDK.
- Passerelle partagée : vous pouvez accéder à KMS en utilisant le point de terminaison public ou un point de terminaison VPC. Pour utiliser le point de terminaison public, vous devez d'abord l'activer. Pour plus d'informations, consultez Accéder à la clé d'une instance KMS via Internet.
- Passerelle dédiée : vous pouvez accéder à KMS en utilisant le point de terminaison privé de l'instance KMS : <YOUR_KMS_INSTANCE_ID>.cryptoservice.kms.aliyuncs.com.

Description

Après avoir appelé l'opération GenerateDataKeyWithoutPlaintext pour obtenir une clé de données chiffrée par une clé maître (CMK), vous pouvez utiliser l'opération ExportDataKey pour distribuer la clé de données vers d'autres régions ou modules cryptographiques. L'opération ExportDataKey renvoie le texte chiffré de la clé de données, rechiffré avec la clé publique spécifiée.

Vous pouvez importer le texte chiffré exporté dans le module cryptographique qui détient la clé privée correspondante. Ce processus vous permet de distribuer en toute sécurité la clé de données de KMS vers un module cryptographique. Une fois la clé de données importée dans le module cryptographique, vous pouvez l'utiliser pour chiffrer ou déchiffrer des données.

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
CiphertextBlob	string	Oui	Le texte chiffré de la clé de données chiffrée à l'aide d'une clé maître (CMK).	ODZhOWVmZDktM2QxNi00ODk0LWJkNGYtMWZjNDNmM2YyYWJmS7FmDBBQ0BkKsQrtRnidtPwirmDcS0ZuJCU41xxAAWk4Z8qsADfbV0b+i6kQmlvj79dJdGOvtX69Uycs901q********
EncryptionContext	object	Non	Une chaîne JSON composée de paires clé-valeur. EncryptionContext est le contexte de chiffrement transmis lors du chiffrement de la clé de données à l'aide d'une CMK. Pour plus d'informations, consultez EncryptionContext.	{"Exemple":"Exemple"}
PublicKeyBlob	string	Oui	La clé publique au format Base64.	MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAndKfC2ReLL2+y8a0+ZBBeAft/uBYo86GZiYJuflqgUzKxpyuvlo3uQkBv6b+nx+0tz8g8v7GhpPWMSW5L9mNHYsvYFsa7jTxsYdt17yj6GlUHPuMIs8hr5qbwl38IHU1iIa7nYWwE2fb3ePOvLDACRJVgGpU0yxioW80d2QD+9aU4jF5dlAahcfgsNzo2CXzCUc1+xbmNuq7Rp+H9VJB9dyYOwqnW3RhOLBo21FzpORapf0UiRlrHRpk1V6ez+aE1dofaYh/9bh0m6ioxj7j5hpZbWccuEZTMBKd+cbuBkRhJzc6Tti6qwZbDiu4fUwbZS0Tqpuo1UadiyxMW********
WrappingKeySpec	string	Oui	Le type de la clé publique spécifiée par PublicKeyBlob. Pour plus d'informations sur les types de clés, consultez Introduction aux clés asymétriques. Valeurs valides : RSA_2048 EC_SM2	RSA_2048
WrappingAlgorithm	string	Oui	L'algorithme de chiffrement utilisé pour chiffrer la clé de données à l'aide de la clé publique spécifiée par PublicKeyBlob. Pour plus d'informations sur les algorithmes, consultez AsymmetricDecrypt. Valeurs valides : RSAES_OAEP_SHA_256 RSAES_OAEP_SHA_1 SM2PKE	RSAES_OAEP_SHA_256
DryRun	string	Non	Indique si le mode de test à blanc doit être activé. true false (valeur par défaut) Le mode de test à blanc est utilisé pour tester l'appel d'API et vérifier les autorisations sur les ressources spécifiées ainsi que la validité des paramètres de la requête. Si vous activez le mode de test à blanc, KMS renvoie une réponse d'échec et une raison d'échec. Les raisons d'échec incluent les éléments suivants : DryRunOperationError : la requête aurait réussi si le paramètre DryRun n'avait pas été spécifié. ValidationError : les paramètres spécifiés dans la requête ne sont pas valides. AccessDeniedError : vous n'êtes pas autorisé à effectuer l'opération sur la ressource KMS.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object
KeyVersionId	string	L'identifiant de la version de clé utilisée pour déchiffrer le texte chiffré de la clé de données spécifiée.	2ab1a983-7072-4bbc-a582-584b5bd8****
KeyId	string	L'identifiant de la CMK utilisée pour déchiffrer le texte chiffré de la clé de données spécifiée. L'identifiant globalement unique de la CMK.	202b9877-5a25-46e3-a763-e20791b5****
RequestId	string	L'identifiant de la requête, qui est un identifiant unique généré par Alibaba Cloud pour la requête. Vous pouvez utiliser l'identifiant de la requête pour résoudre les problèmes.	4bd560a1-729e-45f1-a3d9-b2a33d61046b
ExportedDataKey	string	La clé de données exportée protégée par chiffrement à clé publique.	BQKP+1zK6+ZEMxTP5qaVzcsgXtWplYBKm0NXdSnB5FzliFxE1bSiu4dnEIlca2JpeH7yz1/S6fed630H+hIH6DoM25fTLNcKj+mFB0Xnh9m2+HN59Mn4qyTfcUeadnfCXSWcGBouhXFwcdd2rJ3n337bzTf4jm659gZu3L0i6PLuxM9p7mqdwO0cKJPfGVfhnfMz+f4alMg79WB/NNyE2lyX7/qxvV49ObNrrJbKSFiz8Djocaf0IESNLMbfYI5bXjWkJlX92DQbKhibtQW8ZOJ//ZC6t0AWcUoKL6QDm/dg5koQalcleRinpB+QadFm894sLbVZ9+N4GVs*******

Exemples

JSON format

{
  "KeyVersionId": "2ab1a983-7072-4bbc-a582-584b5bd8****",
  "KeyId": "202b9877-5a25-46e3-a763-e20791b5****",
  "RequestId": "4bd560a1-729e-45f1-a3d9-b2a33d61046b",
  "ExportedDataKey": "BQKP+1zK6+ZEMxTP5qaVzcsgXtWplYBKm0NXdSnB5FzliFxE1bSiu4dnEIlca2JpeH7yz1/S6fed630H+hIH6DoM25fTLNcKj+mFB0Xnh9m2+HN59Mn4qyTfcUeadnfCXSWcGBouhXFwcdd2rJ3n337bzTf4jm659gZu3L0i6PLuxM9p7mqdwO0cKJPfGVfhnfMz+f4alMg79WB/NNyE2lyX7/qxvV49ObNrrJbKSFiz8Djocaf0IESNLMbfYI5bXjWkJlX92DQbKhibtQW8ZOJ//ZC6t0AWcUoKL6QDm/dg5koQalcleRinpB+QadFm894sLbVZ9+N4GVs*******"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidParameter	The specified parameter is not valid.	An invalid value is specified for the parameter.
500	InternalFailure	Internal Failure.
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.