Modos de comando interativo e único

Na CLI do CloudHSM, você pode executar comandos de duas maneiras diferentes: no modo de comando único e no modo interativo. O modo interativo foi projetado para usuários e o modo de comando único foi projetado para scripts.

nota

Todos os comandos funcionam no modo interativo e no modo de comando único.

Modo interativo

Use os comandos a seguir para iniciar o modo interativo da CLI do CloudHSM.

Linux

$ /opt/cloudhsm/bin/cloudhsm-cli interactive

Windows

C:\Program Files\Amazon\CloudHSM\bin\> .\cloudhsm-cli.exe interactive

Ao usar a CLI no modo interativo, você pode fazer login em uma conta de usuário usando o comando do login.

Para listar todos os comandos da CLI do CloudHSM, execute o seguinte comando:

aws-cloudhsm > help

Para obter a sintaxe de um comando da CLI do CloudHSM, execute o seguinte comando:

aws-cloudhsm >  help <command-name> 

Por exemplo, para obter uma lista de usuários nos HSMs, insira user list.

aws-cloudhsm > user list

Para encerrar sua sessão da CLI do CloudHSM, execute o seguinte comando:

aws-cloudhsm > quit

Modo de comando único

Se você executar a CLI do CloudHSM usando o modo de comando único, precisará definir duas variáveis de ambiente para fornecer credenciais: CLOUDHSM_PIN e CLOUDHSM_ROLE:

$ export CLOUDHSM_ROLE=admin

$ export CLOUDHSM_PIN=admin_username:admin_password

Depois de fazer isso, você pode executar comandos usando as credenciais armazenadas em seu ambiente.

$ cloudhsm-cli user change-password --username alice --role crypto-user
Enter password:
Confirm password:
{
    "error_code": 0,
    "data": {
      "username": "alice",
      "role": "crypto-user"
    }
}