暗号文を復号してプレーンテキストに変換します。 - Key Management Service

Decrypt API を呼び出して、暗号文を復号し、プレーンテキストにします。

オペレーションの説明

Encrypt API または GenerateDataKey API を呼び出して暗号文を生成した後、Decrypt を使用して暗号文を復号できます。

キー仕様と暗号化モードの詳細については、「キー管理タイプとキー仕様」をご参照ください。

注意事項

すべてのリクエストパラメーターは Protocol Buffers でエンコードされます。生成されたリクエスト本文は 3 MB を超えることはできません。データ量が 3 MB を超える場合、サーバーはリクエストを拒否し、HTTP ステータスコード 413 を返します。

1 回の暗号化または復号の呼び出しで、データを次の制限内に収めてください。

キータイプ	推奨される最大データ量
対称キー	6 KB
非対称キー	1 KB

データがこれらの制限を超える場合は、代わりにエンベロープ暗号化を使用してください。詳細については、「エンベロープ暗号化」をご参照ください。

説明

1 回の呼び出しでのデータ量が大きいほど、ネットワーク伝送障害のリスクが高くなり、伝送に時間がかかり、KMS インスタンスがデータの暗号化または復号を完了するのに必要な時間も長くなります。

リクエストパラメーター

名前	型	必須	例	説明
KeyId	string	はい	key-hzz62f1cb66fa42qo****	キーのグローバルに一意な識別子です。このパラメーターには、キーエイリアスを指定することもできます。
Algorithm	string	いいえ	AES_GCM	復号アルゴリズムです。重要値は、暗号化に使用したアルゴリズムと同じである必要があります。
Iv	bytes	いいえ	バイナリデータ	初期化ベクトルです。このパラメーターは、復号アルゴリズム (Algorithm パラメーター) が AES_GCM、AES_CBC、またはの場合にのみ必須です。復号アルゴリズム (Algorithm) が AES_CBC の場合、Iv の長さは 16 バイトです。復号アルゴリズム (Algorithm) が AES_GCM またはの場合、Iv の長さは 12 バイトです。重要値は、暗号化時に使用した初期化ベクトルと同じである必要があります。
CiphertextBlob	bytes	はい	バイナリデータ	復号する暗号文です。説明 ECIES アルゴリズムを使用する場合、暗号文の形式は SEC 1: Elliptic Curve Cryptography, Version 2.0 標準に準拠します。
Aad	bytes	いいえ	バイナリデータ	追加認証データです。長さは 8,192 バイトを超えることはできません。このパラメーターは、復号アルゴリズム (Algorithm) が AES_GCM または SM4_GCM であり、暗号化中に追加認証データ (Aad) が指定された場合にのみ必須です。重要値は、暗号化時に使用した追加認証データと同じである必要があります。
PaddingMode	string	いいえ	PKCS7_PADDING	パディングモードです。このパラメーターは、復号アルゴリズムが AES_CBC または AES_ECB の場合にのみ必須です。重要値は、暗号化時に使用したパディングモードと同じである必要があります。有効値： PKCS7_PADDING (デフォルト)：PKCS#7 パディング。プレーンテキストの長さは、ブロック暗号アルゴリズムのブロックサイズ (K バイト) の倍数である必要はありません。プレーンテキストの長さが L バイトの場合、システムは K - (L mod K) バイトをパディングし、各パディングバイトの値は K - (L mod K) になります。 NO_PADDING：プレーンテキストにパディングは適用されません。プレーンテキストの長さは、ブロック暗号アルゴリズムのブロックサイズの整数倍である必要があります。

レスポンスデータ

名前	型	例	説明
Plaintext	bytes	バイナリデータ	復号されたプレーンテキストです。
KeyId	string	key-hzz62f1cb66fa42qo****	キーのグローバルに一意な識別子です。リクエストで KeyId パラメーターとしてキーエイリアスが使用された場合、レスポンスではそのエイリアスに対応するキーのグローバルに一意な識別子が返されます。
Algorithm	string	AES_GCM	復号アルゴリズムです。
PaddingMode	string	PKCS7_PADDING	パディングモードです。
RequestId	string	475f1620-b9d3-4d35-b5c6-3fbdd941423d	リクエスト ID です。Alibaba Cloud はリクエストごとに一意の ID を生成します。このリクエスト ID を使用して、問題をトラブルシューティングできます。

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

500

InternalFailure

Internal Failure.

考えられる原因：

暗号文データが要件を満たしていません。
たとえば、RSA 復号 (RSAES_OAEP_SHA_256) を使用する場合、公開キーがプレーンテキストを暗号化する際に使用されるダイジェストアルゴリズムが SHA-1 である場合や、AES_ECB 復号を使用する場合に暗号文データの長さが 16 バイト (AES アルゴリズムのブロックサイズ) の倍数でない場合などです。
リクエストパラメーターで指定したキーが、暗号化に使用したキーではありません。

上記原因が当てはまらない場合は、テクニカルサポートにお問い合わせください。

エラーコードの詳細については、「共通エラーコード」をご参照ください。