キーラップ cloudhsm-aes-gcm - AWS CloudHSM

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

キーラップ cloudhsm-aes-gcm

key wrap cloudhsm-aes-gcm コマンドは、HSM の AES キーとラCLOUDHSM-AES-GCMッピングメカニズムを使用してペイロードキーをラップします。ペイロードキーの extractable 属性は に設定する必要がありますtrue

キーを作成した Crypto User (CU) であるキーの所有者のみがキーをラップできます。キーを共有するユーザーは、暗号化オペレーションでキーを使用できます。

key wrap cloudhsm-aes-gcm コマンドを使用するには、まず AWS CloudHSM クラスターに AES キーが必要です。key generate-symmetric aes コマンドと wrap 属性を に設定してラップするための AES キーを生成できますtrue

ユーザーのタイプ

このコマンドは、次のタイプのユーザーが実行できます。

  • Crypto User (CU)

要件

  • このコマンドを実行するには、CU としてログインする必要があります。

Syntax

aws-cloudhsm > help key wrap cloudhsm-aes-gcm Usage: key wrap cloudhsm-aes-gcm [OPTIONS] --payload-filter [<PAYLOAD_FILTER>...] --wrapping-filter [<WRAPPING_FILTER>...] --tag-length-bits <TAG_LENGTH_BITS> 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 --payload-filter [<PAYLOAD_FILTER>...] Key reference (e.g. key-reference=0xabc) or space separated list of key attributes in the form of attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE to select a payload key --wrapping-filter [<WRAPPING_FILTER>...] Key reference (e.g. key-reference=0xabc) or space separated list of key attributes in the form of attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE to select a wrapping key --path <PATH> Path to the binary file where the wrapped key data will be saved --aad <AAD> Aes GCM Additional Authenticated Data (AAD) value, in hex --tag-length-bits <TAG_LENGTH_BITS> Aes GCM tag length in bits -h, --help Print help

この例では、AES キーを使用して key wrap cloudhsm-aes-gcm コマンドを使用する方法を示します。

aws-cloudhsm > key wrap cloudhsm-aes-gcm --payload-filter attr.label=payload-key --wrapping-filter attr.label=aes-example --tag-length-bits 64 --aad 0x10 { "error_code": 0, "data": { "payload_key_reference": "0x00000000001c08f1", "wrapping_key_reference": "0x00000000001c08ea", "wrapped_key_data": "6Rn8nkjEriDYlnP3P8nPkYQ8hplOEJ899zsrF+aTB0i/fIlZ" } }

引数

<CLUSTER_ID>

このオペレーションを実行するクラスターの ID。

必須: 複数のクラスターが設定されている場合。

<PAYLOAD_FILTER>

ペイロードキーを選択attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUEするためのキーリファレンス (例: key-reference=0xabc) または 形式のキー属性のスペース区切りリスト。

必須: はい

<PATH>

ラップされたキーデータが保存されるバイナリファイルへのパス。

必須: いいえ

<WRAPPING_FILTER>

ラッピングキーを選択attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUEするためのキーリファレンス (例: key-reference=0xabc) または 形式のキー属性のスペース区切りリスト。

必須: はい

<AAD>

AES GCM Additional Authenticated Data (AAD) 値を 16 進数で表します。

必須: いいえ

<TAG_LENGTH_BITS>

AES GCM タグの長さをビット単位で指定します。

必須: はい

関連トピック