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

# Tambahkan aturan otorisasi melalui Dasbor EMQX untuk pengguna
<a name="add-rules-emqx-broker"></a>

Anda dapat menambahkan atau memperbarui aturan otorisasi menggunakan Dasbor EMQX atau alat EMQX AWS IoT SiteWise CLI. Alat AWS IoT SiteWise CLI EMQX mengelola otorisasi menggunakan database bawaan EMQX.

**catatan**  
Menambahkan aturan otorisasi adalah langkah konfigurasi lanjutan yang memerlukan pemahaman tentang pola topik MQTT dan kontrol akses. *Untuk informasi selengkapnya tentang membuat aturan otorisasi menggunakan database bawaan EMQX, lihat [Menggunakan Basis Data Bawaan](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) di Dokumen 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 ]

Prosedur ini menunjukkan bagaimana Anda dapat menambahkan aturan otorisasi di dasbor EMQX.

Dasbor EMQX hanya dapat diakses dari dalam host gateway. Jika Anda mencoba terhubung dari luar host gateway, Anda tidak dapat mengakses dasbor.

**Untuk menambahkan aturan otorisasi menggunakan Dasbor EMQX**

1. Pastikan Anda berada di dalam host gateway.

1. Buka jendela browser dan kunjungi [http://localhost:18083/](http://localhost:18083/).

1. Masuk ke dasbor EMQX. Prosedur ini mengasumsikan bahwa Anda telah mengubah kredensi login default Anda menjadi sesuatu yang Anda pilih. Untuk informasi lebih lanjut tentang penyiapan awal, lihat[Aktifkan otentikasi nama pengguna dan kata sandi](configure-emqx-broker.md#emqx-broker-username-password-auth).

1. Pilih ikon perisai, lalu **Otorisasi** dari menu tarik-turun.

1. Pilih tombol **Permissions** pada baris **Built-in Database**. 

1. Di bagian otorisasi Basis Data bawaan, tambahkan atau perbarui aturan otorisasi pengguna untuk kebutuhan bisnis Anda. Untuk panduan selengkapnya tentang membuat aturan, lihat bagian [Use Built-in Database](https://docs.emqx.com/en/emqx/latest/access-control/authz/mnesia.html) di Dokumen *EMQX*.

------
#### [ AWS IoT SiteWise CLI tool using Linux ]

**Untuk mengelola aturan otorisasi menggunakan alat AWS IoT SiteWise EMQX CLI di Linux:**
+ Tambahkan aturan otorisasi untuk pengguna menggunakan format berikut:

  ```
  /greengrass/v2/bin/swe-emqx-cli auth add your-username your-action your-permission your-topic [your-action-permission-topic]
  ```

**Example Menambahkan aturan otorisasi untuk pengguna**  
Contoh ini menunjukkan cara menambahkan aturan untuk pengguna bernama`system1`:  

```
/greengrass/v2/bin/swe-emqx-cli auth add system1 \
    publish allow "sensors/#" \
    subscribe allow "control/#" \
    all deny "#"
```

**Example : Lihat aturan otorisasi untuk pengguna**  
Untuk melihat aturan otorisasi bagi `system1` pengguna, jalankan perintah berikut:  

```
/greengrass/v2/bin/swe-emqx-cli auth list system1
```

**Example : Lihat semua aturan otorisasi yang ada**  
Untuk melihat semua aturan otorisasi yang Anda miliki saat ini, jalankan perintah berikut:  

```
/greengrass/v2/bin/swe-emqx-cli auth list
```

**Example : Hapus semua aturan otorisasi untuk pengguna**  
Untuk menghapus semua aturan otorisasi yang diterapkan pada pengguna tertentu, jalankan perintah berikut:  

```
/greengrass/v2/bin/swe-emqx-cli auth delete system1
```
Anda diminta untuk mengkonfirmasi penghapusan.

------
#### [ AWS IoT SiteWise CLI tool using Windows ]

**Untuk mengelola aturan otorisasi menggunakan alat AWS IoT SiteWise EMQX CLI di: Windows PowerShell**
+ Tambahkan aturan otorisasi untuk pengguna menggunakan format berikut:

  ```
  C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth add your-username your-action your-permission your-topic [your-action-permission-topic]
  ```

**Example : Tambahkan aturan otorisasi untuk pengguna**  
Contoh ini menunjukkan cara menambahkan aturan untuk pengguna bernama`system1`:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth add system1 `
    publish allow "sensors/#" `
    subscribe allow "control/#" `
    all deny "#"
```

**Example : Lihat aturan otorisasi untuk pengguna**  
Untuk melihat aturan otorisasi bagi `system1` pengguna, jalankan perintah berikut:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth list system1
```

**Example : Lihat semua aturan otorisasi yang ada**  
Untuk melihat semua aturan otorisasi yang Anda miliki saat ini, jalankan perintah berikut:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth list
```

**Example : Hapus semua aturan otorisasi untuk pengguna**  
Untuk menghapus semua aturan otorisasi yang diterapkan pada pengguna tertentu, jalankan perintah berikut:  

```
C:\greengrass\v2\bin\swe-emqx-cli.ps1 auth delete system1
```
Anda diminta untuk mengkonfirmasi penghapusan.

------