Organisasi

Apa itu organisasi?

Organisasi memungkinkan Anda berbagi aplikasi dengan tim sambil mengontrol siapa yang bisa melakukan apa. Setiap akun Capgo terhubung ke setidaknya satu organisasi, dan Anda bisa membuat organisasi sebanyak yang dibutuhkan.

Akses dikelola melalui kontrol akses berbasis peran (RBAC). Setiap anggota tim diberikan role — baik di level organisasi atau dibatasi pada aplikasi tertentu — yang menentukan apa yang bisa mereka lihat dan lakukan. Akses Channel dapat diatur lebih detail dengan override izin per-channel.

---

Ringkasan Pengaturan Organisasi

Halaman pengaturan Organization dapat diakses dengan klik Pengaturan di sidebar kiri, lalu pilih tab Organisasi di bagian atas. Dari sana, Anda dapat menavigasi bagian berikut:

Tab	Deskripsi
General	Lihat dan edit nama organisasi, logo, dan email manajemen
Anggota	Kelola anggota tim dan izin akses mereka
Grup	Buat dan kelola grup user untuk assign role secara massal
Kunci API	Kelola kunci API untuk akses programatik
Paket	Lihat dan kelola paket langganan Anda
Kredit	Lihat dan beli tambahan credit
Keamanan	Konfigurasi kebijakan keamanan (2FA, persyaratan password)
Penggunaan	Pantau statistik penggunaan organisasi Anda
Log Audit	Lihat activity logs organisasi Anda
Webhook	Konfigurasi integrasi webhook
Penagihan	Kelola informasi billing dan invoice

Cara pindah antar organisasi

Klik pada selector organisasi dropdown di bagian kiri atas sidebar untuk melihat dan pindah antar organisasi yang Anda akses.

---

Mengelola Member

Melihat anggota

Bagian Members menampilkan semua pengguna yang memiliki akses ke organisasi Anda beserta:

• Member: Avatar dan nama
• Role: Role saat ini (Super Admin, Admin, Billing Manager, atau Member) dengan Aktif atau Pending badge
• Aksi: Edit role, kelola akses level aplikasi, atau hapus dari organisasi

Member aktif diurutkan berdasarkan prioritas role. Undangan pending muncul dengan badge Pending badge.

Mengundang member

1. Klik + Tambah tombol di bagian Members
2. Sebuah Pilih role modal akan muncul — pilih role level org untuk anggota baru:

Role level org yang tersedia adalah:

• Member — Akses read-only
• Manajer Penagihan — Akses billing saja
• Admin — Administrasi penuh (tanpa billing, tanpa hapus)
• Super Admin — Kontrol penuh

3. Klik Konfirmasi, lalu isi formulir undangan (email, nama depan/belakang opsional, captcha) dan klik Kirim undangan.

User yang diundang akan menerima email berisi magic link. Setelah mereka menerima, mereka akan ditambahkan ke organisasi dengan role yang dipilih.

Menetapkan role tingkat aplikasi

Selain role tingkat organisasi, Anda bisa memberikan akses ke aplikasi tertentu kepada member dengan role yang lebih spesifik. Klik Kontrol Akses tombol (ikon shield) di samping member untuk membuka modal akses aplikasi:

Dari modal ini Anda bisa:

1. Cari dan pilih aplikasi
2. Pilih role level app dari dropdown

Role level app yang tersedia adalah:

• Admin Aplikasi — Administrasi penuh sebuah app
• Developer Aplikasi — Upload bundle, kelola device, tanpa operasi destruktif
• App Uploader — Baca data app dan upload bundle
• App Reader — Akses read-only ke sebuah app

3. Klik Tetapkan untuk memberikan role tersebut.

Mengubah role anggota

Klik tombol edit (ikon kunci inggris) di samping anggota untuk mengubah role tingkat organisasi. Hal yang sama Pilih role modal akan muncul dengan role saat ini yang sudah terpilih.

Constraints:

• Anda tidak bisa mengubah role pembuat organisasi
• Anda tidak bisa menghapus Super Admin terakhir — harus selalu ada minimal satu
• Menaikkan atau menurunkan role Super Admin mengharuskan Anda sendiri Super Admin

Menghapus anggota

Klik tombol hapus (ikon sampah) di samping anggota. Dialog konfirmasi akan muncul yang memperingatkan bahwa tindakan ini tidak dapat dibatalkan. Klik Hapus untuk konfirmasi. Ini akan segera mencabut semua akses mereka ke organisasi, aplikasi, dan channel-nya.

---

Ringkasan role

Capgo menggunakan kontrol akses berbasis peran dengan role yang diatur berdasarkan scope. Anda bisa memberikan role pada organisasi level (akses ke semuanya), atau membatasi scope-nya ke satu aplikasi. Akses channel dapat dikustomisasi lebih lanjut dengan override izin per-channel.

Role organisasi

Diberikan saat Anda mengundang anggota. Peran ini berlaku di seluruh organisasi.

Peran	Nama internal	Deskripsi
Super Admin	org_super_admin	Kontrol penuh — billing, penghapusan, transfer. Diberikan otomatis kepada pembuat org.
Admin	org_admin	Administrasi penuh — kelola anggota, aplikasi, channel. Tanpa billing, tanpa penghapusan.
Manajer Penagihan	org_billing_admin	Hanya billing — lihat/perbarui pembayaran, invoice, dan audit billing. Tidak punya akses ke app atau member.
Anggota	org_member	Akses read-only di seluruh organisasi dan semua app-nya.

Peran aplikasi

Terbatas pada satu app saja. Gunakan ini jika anggota tim hanya boleh mengerjakan satu app, bukan seluruh organisasi.

Role	Nama internal	Deskripsi
Admin Aplikasi	app_admin	Kontrol penuh pada satu app — channel, device, dan tim. Tidak bisa menghapus atau mentransfer app.
Developer Aplikasi	app_developer	Upload bundle, kelola device, trigger build, dan update channel. Tanpa fitur hapus atau ubah setting.
App Uploader	app_uploader	Akses baca + upload versi bundle baru.
App Reader	app_reader	Read-only — stats, bundle, channel, logs, dan device.

Override izin channel

Secara default, akses channel diwariskan dari role app. Anda bisa melakukan override izin channel tertentu per user atau grup — misalnya, mengizinkan App Reader untuk juga mengasosiasikan bundle pada staging channel. Lihat Manajemen akses level App di bawah untuk cara konfigurasinya.

Tips

Untuk rincian izin per role, hierarki role, dan penggunaan API/CLI, lihat Referensi kontrol akses.

---

Manajemen akses tingkat App

Setiap app memiliki Akses tab khusus untuk mengelola siapa yang memiliki akses ke app dan apa yang bisa mereka lakukan — termasuk role app dan override izin per-channel.

Melihat akses app

Buka aplikasi Anda dan klik Akses tab. Daftar akses menampilkan setiap pengguna atau grup beserta:

• Email — email pengguna (atau nama grup)
• Role — role tingkat aplikasi (App Admin, App Developer, App Uploader, atau App Reader)
• Diberikan pada — kapan role tersebut diberikan
• Aksi — izin channel (ikon perisai), edit role (ikon kunci pas), dan hapus (ikon tempat sampah)

Mengubah role aplikasi

Klik edit tombol (ikon kunci inggris) di samping user untuk mengubah role di level aplikasi:

Pilih role baru dan klik Konfirmasi. Role yang tersedia adalah:

• Developer Aplikasi — Upload bundle, kelola device, tapi tidak bisa operasi destruktif
• App Uploader — Baca data aplikasi dan upload bundle
• App Reader — Akses read-only

Catatan

Admin Aplikasi tidak muncul di modal ini karena ditetapkan dari halaman Members tingkat organisasi. Lihat Menetapkan role tingkat app di atas.

Override izin channel

Klik channel permissions tombol (ikon perisai) di samping user untuk menimpa izin channel default mereka:

Modal ini menampilkan role app user saat ini dan daftar semua channel dengan tiga izin yang dapat diubah secara individual:

Izin	Deskripsi
Baca	Lihat channel dan bundle saat ini
Riwayat	Lihat riwayat penugasan bundle
Hubungkan bundle	Atur atau ubah bundle aktif pada channel

Setiap izin secara default adalah Default (izinkan) — artinya mewarisi dari role aplikasi. Anda bisa mengubah izin apa pun secara eksplisit Izinkan atau Tolak untuk channel tertentu, memberi Anda kontrol granular tanpa mengubah role aplikasi pengguna secara keseluruhan.

---

Grup

Grup memungkinkan Anda menetapkan role ke sekelompok pengguna sekaligus, bukan mengelola setiap anggota satu per satu. Grup berada di bawah organisasi dan dapat menyimpan role binding pada scope mana pun — org atau app.

Contoh: Buat grup “QA Team”, lalu berikan Developer Aplikasi role pada aplikasi produksi Anda, dan setiap anggota grup tersebut akan langsung mendapatkan akses Developer ke aplikasi itu. Saat seseorang bergabung atau keluar dari tim, cukup tambahkan atau hapus mereka dari grup — tidak perlu mengubah role binding satu per satu.

Cara kerja grup

• Sebuah grup adalah berbasis org — grup hanya milik satu organisasi dan tidak bisa mencakup beberapa org sekaligus.
• Anda memberikan role ke grup dengan cara yang sama seperti memberikan role ke user — grup akan muncul sebagai principal dalam role bindings.
• Saat izin user diperiksa, keanggotaan grup mereka akan otomatis divalidasi. Jika salah satu grup mereka memiliki role yang memberikan izin yang dibutuhkan, akses akan diberikan.
• Seorang user bisa tergabung dalam beberapa grup, dan izin dari semua grup tersebut akan digabungkan.

Melihat grup

Navigate to the Grup tab di pengaturan organisasi Anda. Daftar grup menampilkan nama, deskripsi, role, tanggal pembuatan, dan aksi (edit atau hapus).

Membuat grup

Klik + Tambah tombol untuk membuka halaman pembuatan grup:

Isi:

1. Nama (wajib) dan Deskripsi (opsional)
2. Role Organisasi — opsional, tentukan role level org (None, Admin, Billing Manager, atau Member)
3. Kontrol Akses tab — tetapkan role level app dengan mengklik + Tambah App, pilih app, lalu tentukan role (misal: App Uploader, App Developer)

Anda perlu Super Admin atau Admin untuk membuat grup.

Mengelola anggota grup

Klik pada grup untuk membuka tampilan detailnya. Beralih ke Anggota tab:

Di sini Anda dapat melihat anggota saat ini dan email mereka. Klik + Tambah untuk menambah anggota:

Modal akan menampilkan semua anggota organisasi. Cari berdasarkan nama, centang anggota yang ingin ditambahkan, lalu klik Tambah anggota.

Tips

Untuk penggunaan API dan detail teknis tentang grup, lihat Referensi Kontrol Akses — Grup.

---

Penagihan

Hanya Super Admin (org_super_admin) dan Manajer Penagihan (org_billing_admin) dapat mengelola billing. Plan terhubung ke organisasi, bukan ke akun pribadi Anda.

Bahaya

Membeli plan HANYA akan berdampak pada organisasi yang sedang dipilih.

---

FAQ

Bisakah saya membuat lebih dari satu organisasi?

Ya. Anda bisa membuat organisasi sebanyak yang dibutuhkan dan berpindah antar organisasi menggunakan pemilih organisasi di sidebar.

Bagaimana cara konfigurasi kebijakan keamanan?

Super Admin dapat mengonfigurasi penegakan 2FA, kebijakan kata sandi, dan keamanan kunci API dari Keamanan tab. Lihat Keamanan organisasi detailnya.

Bisakah saya memberi akses ke satu aplikasi atau channel saja?

Ya — berikan mereka role dengan cakupan app (seperti Developer Aplikasi atau App Reader) melalui halaman Members atau tab Access di app. Anda bisa menyesuaikan akses mereka lebih detail per channel menggunakan override izin channel. Lihat Referensi kontrol akses untuk daftar role selengkapnya.

Apa perbedaan antara Admin dan App Admin?

Admin (org_admin) memiliki otoritas penuh atas seluruh organisasi — semua aplikasi, semua channel, dan semua anggota. Admin Aplikasi (app_admin) memiliki tingkat kontrol yang sama tetapi hanya untuk satu aplikasi tertentu dan channel-nya. Gunakan App Admin jika ingin mendelegasikan kontrol penuh sebuah aplikasi tanpa memberi akses ke seluruh organisasi.

Lanjutkan dari Organization

Jika Anda menggunakan Organisasi untuk merencanakan operasi dashboard dan API, hubungkan dengan Ringkasan API untuk detail implementasi di API Overview, Pendahuluan untuk detail implementasi di Introduction, Kunci API untuk detail implementasi di API Keys, Perangkat untuk detail implementasi di Devices, dan Bundle untuk detail implementasi di Bundles.