Organisasi

Apa itu organisasi?

Organisasi memungkinkan Anda berbagi aplikasi dengan tim Anda sambil mengontrol siapa saja yang dapat melakukan apa saja. Setiap Capgo akun termasuk dalam organisasi setidaknya satu, dan Anda dapat membuat organisasi sebanyak yang Anda butuhkan.

Akses diatur melalui pengaturan akses berdasarkan peran (RBAC). Setiap anggota tim diberikan peran — baik di tingkat organisasi atau terbatas pada aplikasi tertentu — yang menentukan apa yang mereka lihat dan lakukan. Akses kanal dapat disesuaikan lebih lanjut dengan pengaturan izin kanal per-channel.

---

Ringkasan Pengaturan Organisasi

Halaman Pengaturan Organisasi diakses dengan mengklik Pengaturan dalam sidebar kiri, kemudian memilih tab Organisasi di atas. Dari sana, Anda dapat menavigasi antara bagian-bagian berikut:

Tab	Deskripsi
Umum	Lihat dan edit nama organisasi, logo, dan alamat email pengelolaan
Anggota	Kelola anggota tim dan izin mereka
Grup	Buat dan kelola grup pengguna untuk pengaturan peran massal
API Kunci	Kelola API kunci untuk akses programatik
Rencana	Lihat dan kelola rencana langganan Anda
Kredit	Lihat dan beli kredit tambahan
Keamanan	Konfigurasi kebijakan keamanan (2FA, persyaratan kata sandi)
Penggunaan	Monitor statistik penggunaan organisasi Anda
Log Audit	Lihat log aktivitas untuk organisasi Anda
Webhooks	Konfigurasi integrasi webhook
Billing	Kelola informasi tagihan dan faktur

Cara mengganti organisasi

Klik pada pemilih organisasi dropdown di pojok kiri atas sidebar untuk melihat dan mengganti antara organisasi yang Anda miliki akses ke.

---

Mengelola Anggota

Melihat anggota

Bagian Anggota menampilkan semua pengguna yang memiliki akses ke organisasi Anda dengan:

• Anggota: Foto profil dan nama
• Golongan: Peran saat ini (Super Admin, Admin, Manajer Billing, atau Anggota) dengan Aktif atau Menunggu tanda
• Aksi: Ubah peran, kelola akses aplikasi, atau hapus dari organisasi

Anggota aktif disusun berdasarkan prioritas peran. Undangan yang menunggu muncul dengan tanda Pengajuan oranje.

Mengajak anggota

1. Klik tombol + Tambahkan di bagian Anggota
2. Sebuah Pilih peran modal akan muncul — pilih peran organisasi untuk anggota baru:

Peran-peran yang tersedia di tingkat organisasi adalah:

• Anggota — Akses baca-saja
• Pengelola Tagihan — Akses tagihan saja
• Pengelola — Pengelolaan penuh (tidak ada tagihan, tidak ada penghapusan)
• Super Pengelola — Pengelolaan lengkap

3. Klik KonfirmasiMengisi formulir undangan (email, nama depan/terakhir opsional, captcha) dan klik Kirim Undangan.

Pengundangan akan menerima email dengan tautan ajaib. Ketika mereka menerima, mereka akan ditambahkan ke organisasi dengan peran yang dipilih.

Mengatur peran aplikasi

Selain peran organisasi, Anda dapat memberikan akses anggota ke aplikasi tertentu dengan peran yang lebih spesifik. Klik tombol Akses Kontrol di samping anggota untuk membuka modal akses aplikasi:

Dari modal ini Anda dapat:

1. Cari dan pilih aplikasi
2. Pilih peran aplikasi dari dropdown

Peran-peran aplikasi yang tersedia adalah:

• Pengelola Aplikasi — Penuh pengelolaan aplikasi
• Pengembang Aplikasi — Mengunggah bundle, mengelola perangkat, tetapi tidak ada operasi merusak
• Pengunggah Aplikasi — Baca data aplikasi dan unggah bundle
• Pembaca Aplikasi — Akses baca-saja ke aplikasi

3. Klik Tentukan untuk memberikan peran.

Mengedit peran anggota

Klik tombol edit (ikon obeng) di samping anggota untuk mengubah peran mereka di tingkat organisasi. Hal yang sama Pilih peran modal akan muncul dengan peran saat ini yang dipilih secara otomatis.

Keterbatasan:

• Anda tidak dapat mengubah peran pembuat organisasi
• Anda tidak dapat menghapus Super Admin terakhir — harus ada setidaknya satu
• Mengangkat atau menurunkan Super Admin memerlukan Anda untuk menjadi Super Admin sendiri

Menghapus anggota

Klik tombol hapus (ikon sampah) di samping anggota. Dialog konfirmasi akan muncul mengingatkan bahwa aksi ini tidak dapat dibatalkan. Klik Hapus untuk mengkonfirmasi. Hal ini akan mengambil hak akses mereka ke organisasi, aplikasinya, dan saluran-salurannya secara langsung.

---

Ringkasan Peran

Capgo menggunakan pengaturan akses berdasarkan peran dengan peran yang diorganisir berdasarkan ruang lingkup. Anda dapat menugaskan peran pada tingkat organisasi (akses ke semua hal), atau membatasi ruang lingkupnya ke aplikasi tunggal level (akses ke semua hal), atau membatasi ruang lingkupnya ke aplikasi tunggal. Akses kanal dapat disesuaikan lebih lanjut dengan pengaturan izin per-kanal.

Peran Organisasi

Ditetapkan ketika Anda mengundang anggota. Mereka berlaku di seluruh organisasi.

Peran	Nama internal	Deskripsi
Super Admin	org_super_admin	Kontrol penuh — pembayaran, penghapusan, transfer. Otomatis diberikan kepada pembuat org.
Admin	org_admin	Pengelolaan penuh — mengelola anggota, aplikasi, kanal. Tidak ada pembayaran, tidak ada penghapusan.
Manajer Pembayaran	org_billing_admin	Pembayaran hanya — lihat/ubah pembayaran, faktur, audit pembayaran. Tidak ada akses ke aplikasi atau anggota.
Anggota	org_member	Akses baca-saja di seluruh organisasi dan semua aplikasinya.

Peran Aplikasi

Terbatas pada aplikasi tunggal. Gunakan ini ketika anggota tim hanya bekerja pada satu aplikasi, bukan seluruh organisasi.

Peran	Nama Internal	Deskripsi
Admin Aplikasi	app_admin	Kontrol penuh atas satu aplikasi — saluran, perangkat, tim. Tidak dapat menghapus atau mentransfer aplikasi.
Pengembang Aplikasi	app_developer	Upload bundle, mengelola perangkat, memicu build, memperbarui saluran. Tidak ada penghapusan atau perubahan pengaturan.
Uploader Aplikasi	app_uploader	Akses baca + unggah versi bundle baru.
Pembaca Aplikasi	app_reader	Tidak dapat diedit — statistik, bundle, saluran, log, perangkat.

Pengaturan Izin Saluran

Pengelolaan Akses Aplikasi staging untuk cara mengkonfigurasi ini. Tip Untuk informasi lebih lanjut tentang pengaturan izin saluran, lihat

TIPS

Untuk informasi detail tentang hak akses per peran, struktur peran, dan penggunaan API/CLI lihat Referensi Pengendalian Akses.

---

Pengelolaan Akses Aplikasi

Setiap aplikasi memiliki halaman yang khusus Akses untuk mengelola siapa saja yang memiliki akses ke aplikasi dan apa yang dapat mereka lakukan — termasuk peran aplikasi dan pengaturan hak akses per-channel.

Melihat akses aplikasi

Navigasikan ke aplikasi Anda dan klik Akses Akses daftar menampilkan setiap pengguna atau grup dengan informasi:

• Email — alamat email pengguna (atau nama grup)
• Peran — peran aplikasi mereka (Admin Aplikasi, Pengembang Aplikasi, Pengunggah Aplikasi, atau Pembaca Aplikasi)
• Diberikan pada — kapan peran diberikan
• Aksi — izin saluran (ikon pelindung), edit peran (ikon obeng), dan hapus (ikon sampah)

Mengubah peran aplikasi

Klik tombol ubah (ikon gergaji) di samping pengguna untuk mengubah peran aplikasi mereka:

Pilih peran baru dan klik Konfirmasi. Peran yang tersedia adalah:

• Pengembang Aplikasi — Unggah bundle, manajemen perangkat, tetapi tidak ada operasi merusak
• Pengunggah Aplikasi — Baca data aplikasi dan unggah bundle
• Pengguna Aplikasi Akses baca-saja

Catatan

Pengelola Aplikasi tidak ditampilkan dalam modal ini karena telah ditetapkan dari halaman Anggota tingkat Organisasi. Lihat Mengatur peran aplikasi di atas.

Mengatur izin saluran

Klik tombol izin saluran (ikon pelindung) di samping pengguna untuk mengatasi izin saluran default mereka: __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

Modal menampilkan peran aplikasi saat ini dari pengguna dan menyebutkan semua saluran dengan tiga izin yang dapat diubah secara individu:

Izin	Deskripsi
Baca	Lihat saluran dan paket saat ini
Sejarah	Lihat riwayat pengaturan paket
Hubungkan paket	Atur atau ubah paket aktif pada saluran

Izin setiap izin secara default adalah Default (izinkan) — berarti mengikuti dari peran aplikasi. Anda dapat mengubah izin apa pun untuk secara eksplisit Mengizinkan atau Mengtolak untuk saluran tertentu, memberikan Anda kontrol yang halus tanpa mengubah peran aplikasi pengguna secara keseluruhan.

---

Kelompok

Kelompok memungkinkan Anda menugaskan peran ke sekelompok pengguna sekaligus daripada mengelola setiap anggota secara individu. Sebuah kelompok termasuk dalam organisasi dan dapat menampung ikatan peran di mana saja — org atau aplikasi.

Contoh: Buatlah kelompok “Tim QA”, tugaskan peran “Pengembang Aplikasi” pada aplikasi produksi Anda, dan setiap anggota kelompok itu secara langsung mendapatkan akses Pengembang pada aplikasi tersebut. Ketika seseorang bergabung atau keluar dari tim, cukup tambahkan atau hapus mereka dari kelompok — tidak perlu menyentuh ikatan peran individu. __CAPGO_KEEP_0__ __CAPGO_KEEP_0__

Bagaimana kelompok bekerja

• Sebuah kelompok adalah org-scoped — itu termasuk dalam satu organisasi dan tidak dapat menjangkau organisasi lain.
• Anda menugaskan peran ke kelompok dengan cara yang sama seperti Anda menugaskan peran ke pengguna — kelompok muncul sebagai subjek utama dalam ikatan peran.
• Ketika izin pengguna diperiksa, afiliasi kelompok mereka secara otomatis diresolusi. Jika salah satu kelompok mereka menempatkan peran yang memberikan izin yang diperlukan, akses diberikan.
• Seorang pengguna dapat menjadi anggota beberapa kelompok, dan izin dari semua kelompok digabungkan.

Mengamati kelompok

Navigasikan ke Grup-Grup tab di pengaturan pengaturan organisasi Anda. Daftar grup menampilkan nama, deskripsi, peran, tanggal pembuatan, dan nama, deskripsi, peran, tanggal pembuatan, dan aksi (edit atau hapus).

Membuat Grup

Klik + Tambahkan tombol untuk membuka halaman pembuatan grup:

Isi:

1. Nama (wajib) dan Deskripsi (opsional)
2. Peran organisasi — opsional, tentukan peran org-level (Tidak, Admin, Manajer Pembayaran, atau Anggota)
3. Pengendalian Akses tab — tentukan peran aplikasi-level dengan mengklik + Tambahkan AplikasiUntuk membuat aplikasi, Anda harus memilih aplikasi dan memilih peran (misalnya, Pengunggah Aplikasi, Pengembang Aplikasi)

Anda membutuhkan Super Admin atau Admin untuk membuat kelompok.

Mengelola anggota kelompok

Klik pada kelompok untuk membuka tampilan detailnya. Pindah ke tab: Anggota tab:

Dari sini Anda dapat melihat anggota saat ini dan alamat email mereka. Klik Tambahkan untuk menambahkan anggota:

Modal menampilkan semua anggota organisasi. Cari berdasarkan nama, centang anggota yang ingin Anda tambahkan, dan klik Tambahkan anggota.

Tips

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

---

Pembayaran

Hanya Admin Utama (org_super_admin), dan Pengelola Pembayaran (org_billing_admin) dapat mengelola pembayaran. Rencana terkait dengan organisasi, bukan ke akun pribadi Anda.

Bahaya

Membeli rencana hanya akan mempengaruhi organisasi yang dipilih saat ini.

---

FAQ

Apakah saya dapat membuat lebih dari satu organisasi?

Ya. Anda dapat membuat sebanyak organisasi yang dibutuhkan dan beralih antara mereka menggunakan selector organisasi di sidebar.

Bagaimana saya mengatur kebijakan keamanan?

Admin Utama dapat mengatur penegakan 2FA, kebijakan kata sandi, dan API keamanan kunci dari tab "Keamanan". Lihat "Keamanan Organisasi" untuk detail. Keamanan Bagaimana saya memberikan akses kepada hanya satu aplikasi atau saluran? Bagaimana memberikan akses kepada hanya satu aplikasi atau saluran? Ya — tugaskan mereka peran aplikasi-skop (seperti

Security

app-scoped role (seperti Pembuat Aplikasi atau Pembaca Aplikasi) melalui halaman Anggota atau tab Akses aplikasi. Anda dapat memperhalus akses mereka per saluran menggunakan pengaturan otorisasi saluran. Lihat Referensi Pengendalian Akses untuk daftar lengkap peran.

Apa perbedaan antara Admin dan App Admin?

Admin (org_admin) memiliki otoritas atas organisasi keseluruhan — semua aplikasi, semua saluran, semua anggota. Admin Aplikasi (app_adminmenggunakan tingkat kontrol yang sama, tetapi hanya atas satu aplikasi dan saluran-salurannya. Gunakan Admin Aplikasi ketika Anda ingin menugaskan kontrol penuh atas aplikasi tanpa memberikan akses ke bagian lain dari organisasi.

Lanjutkan dari Organisasi

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