使用 CloudHSM CLI 登录 HSM - AWS CloudHSM
用户类型语法示例参数相关 主题

使用 CloudHSM CLI 登录 HSM

您可以使用 CloudHSM CLI 中的 login 命令登录和退出 AWS CloudHSM 集群中的每个硬件安全模块（HSM）。此命令具有以下子命令：

注意

如果错误登录尝试满五次，则将锁定账户。要解锁账户，管理员必须使用 cloudhsm_cli 中的 user change-password 命令重置您的密码。

如果您的集群中有多个 HSM，在锁定账户前，可能会允许您尝试更多次错误登录。这是因为 CloudHSM 客户端跨各 HSM 均衡负载。因此，您的登录尝试可能不是每次都在相同的 HSM 上开始的。如果您要测试此功能，我们建议您在仅具有一个活动 HSM 的集群上测试。

如果您的集群是在 2018 年 2 月前创建的，则在错误登录尝试满 20 次后锁定账户。

用户类型

以下用户均可运行这些命令。

  • 未激活的管理员

  • Admin

  • 加密用户 (CU)

语法

aws-cloudhsm > help login
Login to your cluster  
        
USAGE:
    cloudhsm-cli login [OPTIONS] --username <USERNAME> --role <ROLE> [COMMAND]
    
Commands:
  mfa-token-sign  Login with token-sign mfa
  help            Print this message or the help of the given subcommand(s)

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

        --username <USERNAME>
            Username to access the Cluster
        
        --role <ROLE>
            Role the user has in the Cluster
            
           Possible values:
           - crypto-user: A CryptoUser has the ability to manage and use keys
           - admin:       An Admin has the ability to manage user accounts

        --password <PASSWORD>
           Optional: Plaintext user's password. If you do not include this argument you will be prompted for it

  -h, --help
          Print help (see a summary with '-h')

示例

此命令使用名为 admin1 的管理员用户凭证登录到集群中的所有 HSM。

aws-cloudhsm > login --username admin1 --role admin
Enter password:
{
  "error_code": 0,
  "data": {
    "username": "admin1",
    "role": "admin"
  }
}

参数

<CLUSTER_ID>

要运行此操作的集群的 ID。

必需：如果已配置多个集群。

<USERNAME>

为用户指定友好名称。最大长度为 31 个字符。唯一允许的特殊字符是下划线 ( _ )。此命令中的用户名不区分大小写，用户名始终以小写形式显示。

必需：是

<ROLE>

指定分配给该用户的角色。此参数为必需参数。有效值为 admin、crypto-user。

要获取用户的角色，请使用 user list 命令。有关 HSM 上的用户类型的详细信息，请参阅了解 HSM 用户。

<PASSWORD>

指定登录到 HSM 的用户的密码。

相关 主题