为 AWS CloudHSM 添加具有多槽功能的集群 - AWS CloudHSM
语法示例参数

为 AWS CloudHSM 添加具有多槽功能的集群

当为 AWS CloudHSM 连接至多个 PKCS #11 槽时，请使用 configure-pkcs11 add-cluster 命令将集群添加至您的配置中。

语法

configure-pkcs11 add-cluster [OPTIONS]
        --cluster-id <CLUSTER ID> 
        [--region <REGION>]
        [--endpoint <ENDPOINT>]
        [--hsm-ca-cert <HSM CA CERTIFICATE FILE>]
        [--server-client-cert-file <CLIENT CERTIFICATE FILE>]
        [--server-client-key-file <CLIENT KEY FILE>]
        [-h, --help]

示例

使用 configure-pkcs11 add-cluster 和 cluster-id 参数，将集群添加至 (ID 为 cluster-1234567) 您的配置。

Linux
$ sudo /opt/cloudhsm/bin/configure-pkcs11 add-cluster --cluster-id cluster-1234567
Windows
C:\Program Files\Amazon\CloudHSM\> .\configure-pkcs11.exe add-cluster --cluster-id cluster-1234567
提示

如果使用 cluster-id 参数和 configure-pkcs11 add-cluster 无法添加集群，请参见以下示例，以获取也需要通过 --region 和 --endpoint 参数识别待添加集群的、更长版本的命令。例如，如果集群的区域与配置默认 AWS CLI 配置区域不同，则应使用 --region 参数使用正确区域。此外，您还可以指定调用用途的 AWS CloudHSM API 端点，这可能是各种网络设置的必要条件，例如使用非默认 AWS CloudHSM DNS 主机名的 VPC 接口端点。

使用 configure-pkcs11 add-cluster、cluster-id、endpoint 和 region 参数，将集群 (ID 为 cluster-1234567) 添加至您的配置。

Linux

        $ sudo /opt/cloudhsm/bin/configure-pkcs11 add-cluster --cluster-id cluster-1234567 --region us-east-1 --endpoint https://cloudhsmv2.us-east-1.amazonaws.com
Windows

        C:\Program Files\Amazon\CloudHSM\> .\configure-pkcs11.exe add-cluster --cluster-id cluster-1234567--region us-east-1 --endpoint https://cloudhsmv2.us-east-1.amazonaws.com

有关 --cluster-id、--region 和 --endpoint 参数的更多信息，请参阅 AWS CloudHSM Client SDK 5 配置参数。

参数

--cluster-id <Cluster ID>

进行 DescribeClusters 调用以查找集群中与集群 ID 关联的所有 HSM 弹性网络接口（ENI）IP 地址。系统将 ENI IP 地址添加至 AWS CloudHSM 配置文件。

注意

如果您在无法访问公共互联网的 VPC 中使用来自 EC2 实例的 --cluster-id 参数，则必须创建与 AWS CloudHSM 连接的接口 VPC 端点。有关 VPC 端点的更多信息，请参阅 AWS CloudHSM 和 VPC 终端节点。

必需：是

--endpoint <Endpoint>

指定用于进行 DescribeClusters 调用的 AWS CloudHSM API 端点。设置此选项时，您必须与 --cluster-id 结合。

必需：否

--hsm-ca-cert <HsmCA Certificate Filepath>

指定 HSM CA 证书的文件路径。

必需：否

--region <Region>

指定集群所在区域。设置此选项时，您必须与 --cluster-id 结合。

如果您不提供 --region 参数，则系统会通过尝试读取 AWS_DEFAULT_REGION 或 AWS_REGION 环境变量选择区域。如果未设置这些变量，则系统会在 AWS Config 文件中检查与您的配置文件关联的区域（通常 ~/.aws/config），除非您在 AWS_CONFIG_FILE 环境变量中指定了其他文件。如果以上均未设置，则系统默认为 us-east-1 区域。

必需：否

--server-client-cert-file <Client Certificate Filepath>

用于 TLS 客户端服务器相互身份验证的客户端认证路径。

只有当您不希望使用客户端软件开发工具包 5 中包含的默认密钥和 SSL/TLS 证书时，才使用此选项。设置此选项时，您必须与 --server-client-key-file 结合。

必需：否

--server-client-key-file <Client Key Filepath>

用于 TLS 客户端-服务器双向身份验证的客户端密钥的路径。

只有当您不希望使用客户端软件开发工具包 5 中包含的默认密钥和 SSL/TLS 证书时，才使用此选项。设置此选项时，您必须与 --server-client-cert-file 结合。

必需：否