Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konfigurasikan broker EMQX
Bagian ini mencakup cara menambahkan nama pengguna dan kata sandi. Ini juga mencakup cara membuat koneksi TLS dari sumber eksternal menggunakan nama pengguna dan kata sandi yang ditambahkan. Anda dapat mengkonfigurasi broker EMQX menggunakan Linux atau. Microsoft Windows
**catatan**
Untuk mengonfigurasi broker, Anda memerlukan perangkat inti yang diatur dengan konfigurasi EMQX default di gateway V3 berkemampuan MQTT Anda.
**penting**
Setelah menyelesaikan prosedur ini, kami sangat menyarankan untuk mengonfigurasi aturan otorisasi. Untuk informasi selengkapnya, lihat [Siapkan aturan otorisasi untuk AWS IoT SiteWise Edge di EMQX](authorization-rules-emqx-broker.md). Aturan otorisasi untuk pengguna tambahan meningkatkan keamanan.
## Perbarui konfigurasi penerapan EMQX untuk otentikasi
**Untuk memperbarui konfigurasi penerapan EMQX untuk otentikasi**
1. Navigasikan ke [konsol AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/) tersebut.
1. Di navigasi kiri, pilih **gateway Edge** di bagian **Edge**.
1. Pilih gateway untuk dikonfigurasi.
1. Di bagian **konfigurasi gateway Edge**, salin nilai perangkat inti **Greengrass** Anda. Simpan untuk digunakan nanti.
1. Buka [konsol AWS IoT](https://console.aws.amazon.com/iot/).
1. **Di navigasi kiri, di bawah bagian **Kelola**, pilih Perangkat **Greengrass**, lalu Deployment.**
1. Temukan nilai perangkat inti yang Anda simpan sebelumnya dan pilih tautan itu untuk membuka penerapan.
1. **Pilih tombol dropdown **Actions**, lalu Revise.**
1. Baca pesan yang muncul lalu pilih **Revise deployment**. Halaman **Tentukan target** muncul.
1. Pilih **Berikutnya** hingga Anda mencapai langkah **Konfigurasi komponen**.
1. Pilih tombol `aws.greengrass.clientdevices.mqtt.EMQX` radio.
1. Pilih tombol **Configure component**. Halaman konfigurasi muncul untuk komponen.
1. Di bawah **Pembaruan konfigurasi**, pilih **Atur ulang ke konfigurasi default untuk versi komponen: 2.\$1. **\$1.
1. Masukkan konfigurasi berikut di bagian **Configuration to merge** berdasarkan OS Anda.
------
#### [ Linux ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"dockerOptions": "-p 8883:8883 -p 127.0.0.1:1883:1883 -p 127.0.0.1:18083:18083 -v emqx-data:/opt/emqx/data -e EMQX_NODE__NAME=emqx@local",
"requiresPrivilege": "true"
}
```
------
#### [ Windows ]
```
{
"emqxConfig": {
"authorization": {
"no_match": "allow"
},
"listeners": {
"tcp": {
"default": {
"enabled": true,
"enable_authn": false
}
},
"ssl": {
"default": {
"enabled": true,
"enable_authn": true,
"ssl_options": {
"verify": "verify_none",
"fail_if_no_peer_cert": false
}
}
}
},
"authentication": {
"enable": true,
"backend": "built_in_database",
"mechanism": "password_based",
"password_hash_algorithm": {
"iterations": 210000,
"mac_fun": "sha512",
"name": "pbkdf2"
},
"user_id_type": "username"
},
"dashboard": {
"listeners": {
"http": {
"bind": 18083
}
}
}
},
"authMode": "bypass",
"requiresPrivilege": "true"
}
```
`dockerOptions`Bidang ini hanya untuk gateway Linux.
------
1. Pilih **Konfirmasi**.
1. Pilih **Berikutnya** sampai Anda mencapai langkah **Review**.
1. Pilih **Deploy**.
1. Setelah penerapan berhasil, lanjutkan ke langkah berikutnya.
## Aktifkan otentikasi nama pengguna dan kata sandi
Bagian ini menunjukkan cara menambahkan nama pengguna dan kata sandi melalui GUI dasbor EMQX.
**catatan**
Instruksi terkait EMQX yang disediakan hanya untuk referensi. Karena dokumentasi dan fitur EMQX dapat berubah seiring waktu, dan kami tidak memelihara dokumentasinya, kami sarankan untuk berkonsultasi dengan [dokumentasi resmi EMQX untuk informasi](https://docs.emqx.com/en/emqx/latest/) terbaru.
------
#### [ EMQX Dashboard ]
**Untuk mengaktifkan otentikasi nama pengguna dan kata sandi melalui dasbor EMQX**
1. Pastikan Anda berada di dalam host gateway.
1. Buka jendela browser dan kunjungi [http://localhost:18083/](http://localhost:18083/).
1. Masukkan nama pengguna default **admin** dan kata sandi default dari**public**. Untuk informasi selengkapnya, lihat [Dasbor EMQX di Dokumen](https://docs.emqx.com/en/emqx/latest/dashboard/introduction.html#first-login) *EMQX*.
1. Setelah login, Anda diminta untuk mengubah kata sandi Anda. Perbarui kata sandi Anda untuk melanjutkan ke Dasbor EMQX.
1. Di navigasi kiri, pilih ikon perisai, lalu **Otentikasi.**
1. Di baris **Built-in Database**, pilih tombol **Users**.
1. Pilih tombol ikon tanda tambah untuk menambahkan pengguna. Layar **Tambah** muncul.
1. Masukkan nama pengguna dan kata sandi untuk pengguna aplikasi eksternal.
1. Pilih **Simpan**. Nama pengguna yang Anda pilih muncul di tabel halaman **Otentikasi**.
**catatan**
Aturan otorisasi yang ada atau default berlaku untuk pengguna baru. Disarankan untuk meninjau dan menyesuaikannya dengan kebutuhan aplikasi eksternal Anda.
------
#### [ EMQX Management with Linux ]
Gunakan alat AWS IoT SiteWise EMQX CLI di. `/greengrass/v2/bin/swe-emqx-cli`
**Untuk mengaktifkan otentikasi nama pengguna dan kata sandi melalui Manajemen EMQX menggunakan Linux**
1. Ubah kata sandi admin dengan menjalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli admin change-pwd
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan pengguna administrator Anda saat ini (default adalah`admin`) dan kata sandi (default adalah`public`).
1. Masukkan dan konfirmasikan kata sandi baru Anda.
Jika berhasil, Anda melihat pesan berikut:
```
admin password changed successfully
```
1. Tambahkan pengguna untuk aplikasi eksternal dengan menjalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli users add
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan nama pengguna untuk pengguna baru.
1. Masukkan dan konfirmasikan kata sandi untuk pengguna baru.
Jika berhasil, Anda melihat pesan berikut:
```
User '[username]' created successfully
```
1. Verifikasi konfigurasi pengguna dengan menjalankan perintah berikut:
```
/greengrass/v2/bin/swe-emqx-cli users list
```
Output menunjukkan semua pengguna yang dikonfigurasi:
```
Users:
- [your-added-username]
Total users: 1
```
------
#### [ EMQX Management with Windows ]
Gunakan alat AWS IoT SiteWise EMQX CLI di salah satu lokasi berikut:
+ PowerShell: `C:\greengrass\v2\bin\swe-emqx-cli.ps1`
+ Prompt Perintah: `C:\greengrass\v2\bin\swe-emqx-cli.bat`
**Untuk mengaktifkan otentikasi nama pengguna dan kata sandi melalui Manajemen EMQX menggunakan Windows**
1. Ubah kata sandi admin dengan menjalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 admin change-pwd
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan pengguna administrator Anda saat ini (default adalah`admin`) dan kata sandi (default adalah`public`).
1. Masukkan dan konfirmasikan kata sandi baru Anda.
Jika berhasil, Anda melihat pesan berikut:
```
admin password changed successfully
```
1. Tambahkan pengguna untuk aplikasi eksternal dengan menjalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users add
```
1. Saat diminta, lakukan hal berikut:
1. Masukkan nama pengguna untuk pengguna baru.
1. Masukkan dan konfirmasikan kata sandi untuk pengguna baru.
Jika berhasil, Anda melihat pesan berikut:
```
User '[username]' created successfully
```
1. Verifikasi konfigurasi pengguna dengan menjalankan perintah berikut:
```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 users list
```
Output menunjukkan semua pengguna yang dikonfigurasi:
```
Users:
- [your-added-username]
Total users: 1
```
------