使用者類型要求語法範例引數相關主題

使用 Cloud 包裝金鑰 AES-ZERO-PAD HSM CLI

使用 CloudHSM 中的 key wrap aes-zero-pad命令CLI，使用硬體安全模組 HSM）上的金鑰和包裝機制AES-ZERO-PAD來包裝承載AES金鑰。承載金鑰的extractable屬性必須設定為 true。

只有建立金鑰的加密使用者（CU）金鑰擁有者可以包裝金鑰。共用金鑰的使用者可在密碼編譯操作中使用金鑰。

若要使用 key wrap aes-zero-pad命令，您必須先在 AWS CloudHSM 叢集中擁有 AES金鑰。您可以使用 wrap 屬性設定為的使用 Cloud 產生對稱AES金鑰HSM CLI命令產生用於包裝的AES金鑰true。

使用者類型

下列類型的使用者可以執行此命令。

加密使用者（CUs）

要求

若要執行此命令，必須以 CU 的身分登入。

語法


aws-cloudhsm > help key wrap aes-zero-pad
Usage: key wrap aes-zero-pad [OPTIONS] --payload-filter [<PAYLOAD_FILTER>...] --wrapping-filter [<WRAPPING_FILTER>...]

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
  -h, --help
          Print help

範例

此範例示範如何使用 AES 金鑰，並將wrap屬性值設定為的 key wrap aes-zero-pad 命令true。


aws-cloudhsm > key wrap aes-zero-pad --payload-filter attr.label=payload-key --wrapping-filter attr.label=aes-example
{
  "error_code": 0,
  "data": {
    "payload_key_reference": "0x00000000001c08f1",
    "wrapping_key_reference": "0x00000000001c08ea",
    "wrapped_key_data": "L1wVlL/YeBNVAw6Mpk3owFJZXBzDLONt"
  }
}

引數

<CLUSTER_ID>

執行此操作的叢集 ID。

必要：如果已設定多個叢集。

<PAYLOAD_FILTER>

索引鍵參考（例如 key-reference=0xabc）或以形式分隔的索引鍵屬性清單attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE，以選取承載索引鍵。

必要：是

<PATH>

儲存封裝金鑰資料的二進位檔案路徑。

必要：否

<WRAPPING_FILTER>

索引鍵參考（例如 key-reference=0xabc）或以形式分隔的索引鍵屬性清單attr.KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE，以選取包裝索引鍵。

必要：是