Organisasi

Apa itu organisasi?

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

Akses diatur melalui kontrol 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-kanal.

---

Ringkasan Pengaturan Organisasi

Halaman Pengaturan Organisasi diakses dengan mengklik Pengaturan di sidebar kiri, kemudian memilih Organisasi tab di bagian atas. Dari sana, Anda dapat berpindah 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	Pandang dan kelola rencana langganan Anda
Kredit	Pandang dan beli kredit tambahan
Keamanan	Konfigurasi kebijakan keamanan (2FA, persyaratan kata sandi)
Penggunaan	Monitor statistik penggunaan organisasi Anda
Log Audit	Pandang log aktivitas untuk organisasi Anda
Webhook	Konfigurasi integrasi webhook
Pembayaran	Kelola informasi pembayaran dan faktur

Cara mengganti organisasi

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

---

Mengelola Anggota

Melihat anggota

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

• Anggota: Foto profil dan nama
• Peran: 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 menunggu muncul dengan warna oranye Menunggu badge.

Mengundang anggota

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

Peran organisasi yang tersedia:

• Anggota — Akses baca saja
• Pengelola Tagihan — Akses tagihan saja
• Pengatur — Pengaturan lengkap (tidak ada tagihan, tidak ada penghapusan)
• Super Pengatur — Kontrol lengkap

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

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

Mengasignkan peran aplikasi

Selain peran organisasi, Anda dapat memberikan akses anggota ke aplikasi tertentu dengan peran yang lebih spesifik. Klik tombol Access Control (ikon pelindung) di samping anggota untuk membuka modal akses aplikasi:

Dari modal ini Anda dapat:

1. Mencari dan memilih aplikasi
2. Memilih peran aplikasi dari dropdown

Peran aplikasi yang tersedia adalah:

• Admin Aplikasi — Penuh pengaturan administratif sebuah aplikasi
• Pengembang Aplikasi — Unggah bundle, kelola perangkat, tetapi tidak ada operasi merusak
• Uploader Aplikasi — Baca data aplikasi dan unggah bundle
• Pembaca Aplikasi — Akses baca-saja ke sebuah aplikasi

3. Klik Tetapkan untuk memberikan hak akses.

Mengedit hak akses 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 sudah dipilih secara otomatis.

Keterbatasan:

• Tidak bisa mengubah peran pembuat organisasi
• Tidak bisa 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 yang mengingatkan bahwa aksi ini tidak dapat dibatalkan. Klik Hapus untuk memastikan. Ini menggugurkan semua akses mereka ke organisasi, aplikasinya, dan salurannya segera.

---

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 membatasinya ke aplikasi tunggal. Akses saluran dapat disesuaikan lebih lanjut dengan pengaturan izin saluran per-saluran.peran organisasi

peran aplikasi

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

Peran	Nama internal	Deskripsi
Super Admin	org_super_admin	Kontrol penuh — pembayaran, penghapusan, transfer. Ditetapkan secara otomatis kepada pembuat organisasi.
Admin	org_admin	Pengaturan penuh — mengelola anggota, aplikasi, saluran. Tidak ada pembayaran, tidak ada penghapusan.
Manajer Pembayaran	org_billing_admin	Pembayaran hanya — lihat/update 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 boleh bekerja pada satu aplikasi, bukan organisasi keseluruhan.

Peran	Nama Internal	Deskripsi
Admin Aplikasi	app_admin	Kontrol penuh atas satu aplikasi — saluran, perangkat, tim. Tidak dapat menghapus atau mengalihkan aplikasi.
Pengembang Aplikasi	app_developer	Muat bundle, kelola perangkat, trigger build, update saluran. Tidak dapat menghapus atau mengubah pengaturan.
Uploader Aplikasi	app_uploader	Akses baca + unggah versi bundle baru.
Aplikasi Pembaca	app_reader	Akses baca — statistik, bundle, saluran, log, perangkat.

Penetapan Izin Saluran

Dengan default, akses saluran diwarisi dari peran aplikasi. Anda dapat mengatasi izin saluran tertentu per pengguna atau grup — misalnya, memungkinkan Aplikasi Pembaca juga menghubungkan bundle pada saluran. Lihat staging Pengelolaan Akses Aplikasi di bawah ini untuk cara mengkonfigurasi ini. Tip

Untuk penjelasan izin lengkap per peran, hierarki peran, dan penggunaan __CAPGO_KEEP_0__/__CAPGO_KEEP_1__ lihat

API/CLI Pengaturan Kontrol Akses.

---

Pengelolaan Akses Aplikasi

Masing-masing aplikasi memiliki pengaturan Akses tab di mana Anda dapat mengelola siapa saja yang memiliki akses ke aplikasi dan apa yang dapat mereka lakukan — termasuk peran aplikasi dan pengaturan izin kanal per-channel.

Mengamati akses aplikasi

Pergi ke aplikasi Anda dan klik tab Akses Daftar akses menampilkan setiap pengguna atau grup dengan: __CAPGO_KEEP_0__

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

Mengubah peran aplikasi

Klik tombol edit button (wrench icon) di samping pengguna untuk mengubah peran aplikasi mereka:

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

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

Perlu diingat

Admin 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 tombol (ikon pelindung) di samping pengguna untuk mengatasi izin saluran default mereka:

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

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

Setiap izin default adalah Default (izinkan) — berarti mengikuti dari peran aplikasi. Anda dapat mengubah izin apa pun untuk secara eksplisit Izinkan atau Ditolak untuk saluran tertentu, memberikan 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 langsung mendapatkan akses Pengembang ke aplikasi tersebut. Ketika seseorang bergabung atau keluar dari tim, cukup tambahkan atau hapus mereka dari kelompok — tidak perlu menyentuh ikatan peran individu.

Bagaimana kelompok bekerja

• Sebuah kelompok adalah terikat pada organisasi — itu milik satu organisasi dan tidak dapat menyebar ke organisasi lain.
• Anda menugaskan peran ke kelompok dengan cara yang sama seperti Anda menugaskan peran ke pengguna — kelompok muncul sebagai subjek dalam ikatan peran.
• Ketika izin pengguna diperiksa, afiliasi kelompok pengguna secara otomatis diresolusi. Jika salah satu kelompok mereka memegang peran yang memberikan izin yang diperlukan, akses diberikan.
• Seorang pengguna dapat menjadi anggota beberapa kelompok, dan izin dari semua kelompok dikombinasikan.

Mengamati kelompok

Navigasikan ke tab Kelompok di pengaturan organisasi Anda. Daftar kelompok menampilkan setiap kelompok’s Daftar kelompok menampilkan setiap kelompok’s nama, deskripsi, peran, tanggal pembuatan, dan aksi (edit atau hapus).

Membuat sebuah kelompok

Klik tombol + Tambah untuk membuka halaman pembuatan kelompok:

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 dengan mengklik + Tambah Aplikasi, memilih aplikasi, dan memilih peran (misalnya, Pengunggah Aplikasi, Pengembang Aplikasi)

Anda perlu Super Admin atau Admin untuk membuat kelompok.

Mengelola anggota kelompok

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

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

Modal menampilkan semua anggota organisasi. Cari dengan nama, centang anggota yang ingin ditambahkan, dan klik Tambahkan anggota.

Tips

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

---

Pembayaran

Hanya Admin Utama yang Dilindungi (org_super_admin) dan Manajer Billing (org_billing_admin) dapat mengelola billing. 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 berganti antara mereka menggunakan pemilih organisasi di sidebar.

Bagaimana cara saya mengonfigurasi kebijakan keamanan?

Admin Utama dapat mengonfigurasi penegakan 2FA, kebijakan kata sandi, dan API keamanan kunci dari tab ‘Keamanan’. Keamanan Lihat Keamanan Organisasi Apakah saya bisa memberikan akses kepada seseorang hanya untuk satu aplikasi atau saluran?

Judul bagian “Apakah saya bisa memberikan akses kepada seseorang hanya untuk satu aplikasi atau saluran?”

Pengembang Aplikasi atau dapat Reader Aplikasi) melalui halaman Anggota atau tab Akses aplikasi. Anda dapat menyesuaikan lebih lanjut 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 seluruhnya — semua aplikasi, semua saluran, semua anggota. App Admin (app_admin) memiliki tingkat kontrol yang sama tetapi hanya atas satu aplikasi tertentu dan salurannya. Gunakan App Admin ketika Anda ingin menugaskan kontrol penuh atas aplikasi tanpa memberikan akses ke bagian lain dari org.

Teruskan dari Organisasi

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