使用 Cloud 生成非对称密钥 HSM CLI - AWS CloudHSM
生成密RSA钥

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

使用 Cloud 生成非对称密钥 HSM CLI

使用中列出的命令云端中的 generate-asymmetric-pair类别 HSM CLI为 AWS CloudHSM 集群生成非对称密钥对。

生成密RSA钥

使用key generate-asymmetric-pair rsa命令生成 RSA key pair。要查看所有可用的选项，请使用 help key generate-asymmetric-pair rsa 命令。

以下示例生成一个 RSA 2048 位的密钥对。

aws-cloudhsm > key generate-asymmetric-pair rsa \
    --public-exponent 65537 \
    --modulus-size-bits 2048 \
    --public-label rsa-public-example \
    --private-label rsa-private-example

参数

<PUBLIC_LABEL>

为公有密钥指定用户定义的标签。

必需：是

<PRIVATE_LABEL>

为私有密钥指定用户定义的标签。

必需：是

<MODULUS_SIZE_BITS>

指定模数的长度 (以位为单位)。最小值为 2048。

必需：是

<PUBLIC_EXPONENT>

指定公有指数。此值必须为大于或等于 65537 的奇数。

必需：是

<PUBLIC_KEY_ATTRIBUTES>

以KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE（例如token=true）的形式指定要为生成的RSA公钥设置的以空格分隔的密钥属性列表。

有关支持的 AWS CloudHSM 密钥属性的列表，请参阅云的关键属性 HSM CLI。

必需：否

<SESSION>

创建仅在当前会话中存在的密钥。会话结束后，密钥无法恢复。如果您只需要一个短暂的密钥，例如用于加密然后快速解密另一个密钥的包装密钥，请使用此参数。对于会话结束后可能需要解密的加密数据，切勿使用会话密钥。

要将会话密钥更改为永久（令牌）密钥，请使用 key set-attribute。

默认情况下，生成密钥时，它们是永久密钥/令牌密钥。使用 < SESSION > 可以更改此设置，确保使用此参数生成的密钥是会话/临时密钥

必需：否

生成 EC (椭圆曲线加密) 密钥对

使用 key generate-asymmetric-pair ec 命令生成 EC 密钥对。要查看所有可用选项（包括受支持的椭圆曲线的列表），请使用 help key generate-asymmetric-pair ec 命令。

以下示例使用 Secp384r1 椭圆曲线生成一个 EC 密钥对。

aws-cloudhsm > key generate-asymmetric-pair ec \
    --curve secp384r1 \
    --public-label ec-public-example \
    --private-label ec-private-example

参数

<PUBLIC_LABEL>

为公有密钥指定用户定义的标签。客户端 SDK 5.11 及更高版本允许的最大大小label为 127 个字符。客户端 SDK 5.10 及之前的版本限制为 126 个字符。

必需：是

<PRIVATE_LABEL>

为私有密钥指定用户定义的标签。客户端 SDK 5.11 及更高版本允许的最大大小label为 127 个字符。客户端 SDK 5.10 及之前的版本限制为 126 个字符。

必需：是

<CURVE>

指定椭圆曲线的标识符。

有效值：

  • prime256v1

  • secp256r1

  • secp224r1

  • secp384r1

  • secp256k1

  • secp521r1

必需：是

<PUBLIC_KEY_ATTRIBUTES>

以 KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE（例如 token=true）的形式指定要为生成的 EC 公有密钥设置的以空格分隔的密钥属性列表。

有关支持的 AWS CloudHSM 密钥属性的列表，请参阅云的关键属性 HSM CLI。

必需：否

<PRIVATE_KEY_ATTRIBUTES>

以 KEY_ATTRIBUTE_NAME=KEY_ATTRIBUTE_VALUE（例如 token=true）的形式指定要为生成的 EC 私有密钥设置的以空格分隔的密钥属性列表。

有关支持的 AWS CloudHSM 密钥属性的列表，请参阅云的关键属性 HSM CLI。

必需：否

<SESSION>

创建仅在当前会话中存在的密钥。会话结束后，密钥无法恢复。如果您只需要一个短暂的密钥，例如用于加密然后快速解密另一个密钥的包装密钥，请使用此参数。对于会话结束后可能需要解密的加密数据，切勿使用会话密钥。

要将会话密钥更改为永久（令牌）密钥，请使用 key set-attribute。

默认情况下，生成的密钥是永久（令牌）密钥。传入 < SESSION > 可以改变这一点，确保使用此参数生成的密钥是会话（临时）密钥。

必需：否