Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Masuk ke HSM menggunakan CloudHSM CLI
<a name="cloudhsm_cli-login"></a>

Anda dapat menggunakan **login** perintah di CloudHSM CLI untuk masuk dan keluar dari setiap keamanan perangkat keras (HSM) dalam sebuah cluster. AWS CloudHSM Perintah ini memiliki sub-perintah berikut:
+ [mfa-token-sign](cloudhsm_cli-login-mfa-token-sign.md)

**catatan**  
Jika Anda melebihi lima upaya masuk yang salah, akun Anda terkunci. Untuk membuka kunci akun, admin harus mengatur ulang kata sandi Anda menggunakan perintah [ubah kata sandi pengguna di cloudhsm\$1cli](cloudhsm_cli-user-change-password.md).

## Untuk memecahkan masalah login dan logout
<a name="troubleshoot-login-logout"></a>

Jika Anda memiliki lebih dari satu HSM di klaster Anda, Anda mungkin diizinkan untuk upaya login salah tambahan sebelum akun Anda terkunci. Ini karena klien CloudHSM menyeimbangkan beban di berbagai jenis. HSMs Oleh karena itu, upaya login mungkin tidak dimulai pada HSM yang sama setiap saat. Jika Anda menguji fungsionalitas ini, kami sarankan Anda melakukannya pada sebuah klaster dengan hanya satu HSM aktif. 

Jika Anda membuat klaster sebelum Februari 2018, akun Anda terkunci setelah 20 upaya login salah. 

## Jenis pengguna
<a name="chsm-cli-login-logout-userType"></a>

Pengguna berikut dapat menjalankan perintah ini.
+ Admin yang tidak aktif
+ Admin
+ Pengguna kripto (CU)

## Sintaksis
<a name="chsm-cli-login-syntax"></a>

```
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')
```

## Contoh
<a name="chsm-cli-login-example"></a>

**Example**  
Perintah ini mencatat Anda ke semua HSMs dalam klaster dengan kredensi pengguna admin bernama. `admin1`  

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

## Pendapat
<a name="login-arguments"></a>

***<CLUSTER\$1ID>***  
ID cluster untuk menjalankan operasi ini pada.  
Wajib: Jika beberapa cluster telah [dikonfigurasi](cloudhsm_cli-configs-multi-cluster.md).

***<USERNAME>***  
Menentukan nama yang mudah diingat untuk pengguna. Panjang maksimum adalah 31 karakter. Satu-satunya karakter khusus yang diizinkan adalah garis bawah (\$1). Nama pengguna tidak peka huruf besar/kecil dalam perintah ini, nama pengguna selalu ditampilkan dalam huruf kecil.  
Wajib: Ya

***<ROLE>***  
Menentukan peran yang ditetapkan untuk pengguna ini. Nilai yang valid adalah**admin**,**crypto-user**.  
Untuk mendapatkan peran pengguna, gunakan **user list** perintah. Untuk informasi rinci tentang jenis pengguna di HSM, lihat [Memahami pengguna HSM](manage-hsm-users.md).  
Wajib: Ya

***<PASSWORD>***  
Menentukan password dari pengguna yang masuk ke. HSMs  
Wajib: Pelanggan harus memberikan kata sandi baik melalui argumen baris `--password` perintah atau menghilangkannya untuk diminta secara interaktif.  
Menggunakan `--password` argumen pada baris perintah dapat mengekspos kredenal dalam riwayat shell Anda. Pertimbangkan untuk meminta kata sandi secara interaktif atau menghapus riwayat shell Anda setelah digunakan.

## Topik terkait
<a name="login-seeAlso"></a>
+ [Memulai dengan CloudHSM CLI](cloudhsm_cli-getting-started.md)
+ [Aktifkan Cluster](activate-cluster.md)