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

# Prasyarat untuk menggunakan Klien Windows AWS CloudHSM
<a name="ksp-library-prereq"></a>

Sebelum Anda dapat memulai AWS CloudHSM klien Windows dan menggunakan penyedia KSP dan CNG, Anda harus mengatur kredensi login untuk HSM di sistem Anda. Anda dapat mengatur kredensial melalui Windows Credential Manager atau variabel lingkungan sistem. Kami sarankan Anda menggunakan Windows Credential Manager untuk menyimpan kredensial. Opsi ini tersedia dengan versi AWS CloudHSM klien 2.0.4 dan yang lebih baru. Menggunakan variabel lingkungan lebih mudah untuk mengatur, tapi kurang aman daripada menggunakan Windows Credential Manager.

## Pengelola Kredensional Windows
<a name="wcm"></a>

Anda dapat menggunakan utilitas `set_cloudhsm_credentials` atau antarmuka Windows Credentials Manager.
+ **Menggunakan utilitas `set_cloudhsm_credentials`**:

  Utilitas `set_cloudhsm_credentials` disertakan dalam penginstal Windows Anda. Anda dapat menggunakan utilitas ini untuk dengan mudah melewati kredensial login HSM ke Windows Credential Manager. Jika Anda ingin mengompilasi utilitas ini dari sumber, Anda dapat menggunakan kode Python yang disertakan dalam installer.

  1. Pergi ke folder `C:\Program Files\Amazon\CloudHSM\tools\`.

  1. Jalankan file `set_cloudhsm_credentials.exe` dengan parameter nama pengguna dan kata sandi CU.

     ```
     set_cloudhsm_credentials.exe --username {{<CU USER>}} --password {{<CU PASSWORD>}}
     ```
+ **Menggunakan antarmuka Credential Manager**:

  Anda dapat menggunakan antarmuka Credential Manager untuk mengelola kredensial Anda secara manual.

  1. Untuk membuka Credential Manager, ketik `credential manager` di kotak pencarian pada bilah tugas dan pilih**Credential Manager**.

  1. Pilih **Kredensial Windows** untuk mengelola kredensial Windows.

  1. Pilih **Tambah kredensial generik** dan isi detail sebagai berikut:
     + Di **Alamat Internet atau Jaringan**, masukkan nama target sebagai `cloudhsm_client`.
     + Di **Nama pengguna** dan **Kata Sandi**, masukkan kredensial CU.
     + Klik **OK**.

## Variabel lingkungan sistem
<a name="enviorn-var"></a>

Anda dapat mengatur variabel lingkungan sistem yang mengidentifikasi HSM dan [pengguna kripto](understanding-users-cmu.md#crypto-user-cmu) (CU) untuk aplikasi Windows Anda. Anda dapat menggunakan [perintah **setx**](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/setx) untuk mengatur variabel lingkungan sistem, atau mengatur variabel lingkungan sistem permanen [secara terprogram](https://msdn.microsoft.com/en-us/library/system.environment.setenvironmentvariable(v=vs.110).aspx) atau di tab **Lanjutan** dari Panel Kontrol Windows **Properti Sistem**. 

**Awas**  
Ketika Anda mengatur kredensial melalui variabel lingkungan sistem, kata sandi tersedia dalam teks terang pada sistem pengguna. Untuk mengatasi masalah ini, gunakan Windows Credential Manager.

Atur variabel lingkungan sistem berikut:

**`n3fips_password={{<CU USERNAME>}}:{{<CU PASSWORD>}}`**  
Mengidentifikasi [pengguna kripto](understanding-users-cmu.md#crypto-user-cmu) (CU) di HSM dan menyediakan semua informasi login yang diperlukan. Aplikasi Anda mengautentikasi dan berjalan sebagai CU ini. Aplikasi memiliki izin CU ini dan dapat melihat dan mengelola hanya kunci yang CU miliki dan bagikan. Untuk membuat CU baru, gunakan [createUser](cloudhsm_mgmt_util-createUser.md). Untuk menemukan yang ada CUs, gunakan [ListUsers](cloudhsm_mgmt_util-listUsers.md).  
Contoh:  

```
setx /m n3fips_password test_user:password123
```