Katalog izin

Katalog ini diambil dari GET /api/v1/permissions/catalog dan dipakai di editor role, direct policy, dan Personal Access Token. Cara kerja evaluasi dijelaskan di Anggota dan role.

Scope dan aksi

Scope	Aksi
workspace	read, write, delete, manage, role.manage, policy.manage, member.invite
device (termasuk gateway)	read, write, delete, connect, publish, subscribe, configure, role.manage, policy.manage
device_type	read, write, role.manage, policy.manage
channel	read, write, delete, connect, publish, subscribe, role.manage, policy.manage
group	read, write, delete, set_parent, set_child, manage_members, connect, publish, subscribe, configure, role.manage, policy.manage
rule	read, write, delete, execute, alarm_read, alarm_update, alarm_delete, alarm_assign, alarm_acknowledge, alarm_resolve, role.manage, policy.manage
report	read, write, delete, execute, role.manage, policy.manage
alarm	read, update, delete, assign, acknowledge, resolve
dashboard	read, write, delete, share
bootstrap	read, write, delete, manage, role.manage, policy.manage
firmware	read, write (unggah dan hapus berkas), rollout (buat dan kendalikan rollout)

Wildcard * pada scope atau aksi berarti semuanya (hanya untuk role, tidak untuk token atau direct policy).

Penjelasan aksi penting

Aksi	Arti
workspace.read	Syarat minimal untuk membuka workspace.
workspace.manage	Melihat Journals workspace dan mengekspor backup workspace.
workspace.member.invite	Mengundang, mengirim ulang, dan mencabut undangan.
channel.connect, device.connect	Membuat dan memutus koneksi (dibutuhkan di kedua sisi).
channel.publish, channel.subscribe	Mengirim pesan ke channel dari aplikasi (Kirim pesan, widget kontrol) dan melihat pesan Live.
device.configure	Menyimpan dan mengirim setelan perangkat, perintah, rules di device, dan kontrol output.
group.set_parent, set_child, manage_members	Memindah group dalam hierarki dan mengelola anggota.
rule.execute	Menjalankan rule terjadwal sekarang.
rule.alarm_* / alarm.*	Menangani alarm. Salah satunya cukup.
dashboard.share	Mengatur opsi berbagi dashboard, termasuk tautan publik.
*.role.manage, *.policy.manage	Mengelola role dan direct policy pada objek (bagian Access).

Pewarisan lewat group

Block ber-scope group berlaku untuk group itu, group anak, dan device serta channel anggotanya, dengan nama aksi yang sama. Untuk itu scope group juga memuat connect, publish, subscribe, dan configure.

Device type dan bootstrap

Izin device tingkat scope (tanpa objek atau tag) juga berlaku untuk device type lewat pewarisan. Direct policy dan tab Access tersedia untuk device type dan bootstrap.

Role bawaan

Role	Izin
Admin	Semua aksi pada semua scope. Tidak bisa dihapus atau dikurangi.
Member	Membaca semua entitas di workspace.
Operator	Membaca semua, channel.publish, device.publish, aksi alarm pada rule (alarm_read, alarm_acknowledge, alarm_resolve), serta alarm.acknowledge dan alarm.resolve. Tidak memiliki device.configure dan scope firmware.
Viewer	Hanya workspace.read dan dashboard.read.

Izin pada Personal Access Token

Token hanya menerima block allow, dan menolak aksi manajemen akses: manage, role.manage, policy.manage, member.invite, serta *. Hak efektif token adalah irisan antara hak pemilik dan scope token (Profil dan token).

Tips

Beri hak sekecil mungkin. Contoh peran “integrasi pembaca”: workspace.read dan channel.read. Contoh “perangkat lunak pengirim perintah”: tambah channel.publish dan device.configure pada device tertentu lewat batas tag.