GCM用 AES-使用 Cloud 封装密钥 HSM CLI - AWS CloudHSM
用户类型要求语法示例参数相关 主题

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

GCM用 AES-使用 Cloud 封装密钥 HSM CLI

使用 Cloud HSM CLI 中的key wrap aes-gcm命令使用硬件安全模块 (HSM) 和AES-GCM包装机制上的AES密钥封装有效载荷密钥。有效载荷密钥的extractable属性必须设置为true。

只有密钥的所有者，即创建密钥的加密用户 (CU)，才能封装密钥。共享密钥的用户可以在加密操作中使用该密钥。

要使用该key wrap aes-gcm命令，您必须先在 AWS CloudHSM 集群中拥有AES密钥。您可以生成用于包装的AES密钥，并将使用 Cloud 生成对称AES密钥 HSM CLI命令和wrap属性设置为true。

用户类型

以下类型的用户均可运行此命令。

  • 加密用户 (CUs)

要求

  • 要运行此命令，必须以 CU 身份登录。

语法

aws-cloudhsm > help key wrap aes-gcm
Usage: key wrap 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 aes-gcm命令。

aws-cloudhsm > key wrap 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",
    "iv": "0xf90613bb8e337ec0339aad21",
    "wrapped_key_data": "xvslgrtg8kHzrvekny97tLSIeokpPwV8"
  }
}

参数

<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为，用于选择换行密钥。

必需：是

<AAD>

AESGCM其他经过身份验证的数据 (AAD) 值，以十六进制表示。

必需：否

<TAG_LENGTH_BITS>

AESGCM标签长度（以位为单位）。

必需：是

相关 主题