SSO (Enterprise)
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Apa itu SSO?
Bagian berjudul “Apa itu SSO?”Single Sign-On (SSO) memungkinkan tim Anda login ke Capgo menggunakan identity provider (IdP) perusahaan Anda. Capgo menggunakan SAML 2.0 lewat Supabase Auth. Saat domain email pengguna cocok dengan provider SSO yang aktif, mereka bisa autentikasi ke IdP Anda dan otomatis ditambahkan ke organisasi saat callback SSO.
SSO tidak mengubah apa yang bisa dilakukan pengguna. Permission dikontrol oleh role organisasi. SSO hanya mengubah cara mereka autentikasi.
Prerequisites
Bagian berjudul “Prasyarat”Sebelum memulai:
- Langganan Enterprise aktif di organisasi Capgo.
- Identity provider yang mendukung SAML 2.0 dan mengekspos IdP URL metadata (HTTPS).
- Kemampuan untuk menerbitkan rekaman DNS TXT untuk domain email (mis.
company.comuntuk pengguna yang login sebagaiuser@company.com). - Anggota organisasi Capgo dengan izin untuk memperbarui pengaturan organisasi.
- Sebuah admin IdP di sisi IT/keamanan Anda.
Cara menemukan pengaturan SSO
Bagian berjudul “Di mana menemukan pengaturan SSO”- Buka https://console.capgo.app/
- Klik Pengaturan di bilah sisi kiri
- Pilih Organisasi tab
- Pilih Keamanan tab
- Gulir ke Konfigurasi SSO. Formulir ini hanya tersedia jika organisasi menggunakan paket Enterprise.
Langkah 1 - Konfigurasikan IdP Anda
Bagian berjudul “Langkah 1 - Konfigurasi IdP Anda”Di identity provider Anda, buat aplikasi SAML 2.0 baru. Anda akan membutuhkan Penyedia Layanan nilai yang ditampilkan di panel konfigurasi SSO Capgo:
| Kolom | Di mana digunakan |
|---|---|
| URL ACS | Assertion Consumer Service URL di aplikasi SAML IdP Anda |
| ID Entitas | Pengenal entitas Service Provider |
| URL metadata SP | Opsional: impor jika IdP Anda mendukung impor metadata SP via URL |
| Format NameID | Format yang diharapkan untuk SAML Name Identifier |
IdP Anda harus mengirimkan alamat email pengguna dalam assertion. Capgo menggunakan domain email untuk menentukan provider SSO aktif dan mencocokkan akun yang ada.
Langkah 2 - Tambahkan provider SSO di Capgo
Bagian berjudul “Langkah 2 - Tambahkan provider SSO di Capgo”- Di panel konfigurasi SSO, klik untuk menambah provider baru
- Masukkan domain email (mis.
company.com). Harus cocok dengan bagian domain email login pengguna Anda - Masukkan IdP Anda URL metadata (HTTPS)
- Kirim
Provider dibuat dengan status Menunggu verifikasi.
Langkah 3 - Verifikasi domain DNS
Bagian berjudul “Langkah 3 - Verifikasi domain DNS”Capgo memverifikasi bahwa Anda mengontrol domain sebelum SSO dapat diaktifkan.
Tambahkan TXT record di penyedia DNS Anda:
| Kolom | Nilai |
|---|---|
| Tipe | TXT |
| Nama / host | _capgo-sso.<your-domain> (mis. _capgo-sso.company.com) |
| Nilai | Token verifikasi yang ditampilkan di panel dashboard |
Setelah record dipublikasikan (propagasi DNS TTL biasanya butuh beberapa menit hingga satu jam), klik Verifikasi DNS di dashboard. Jika berhasil, provider berpindah ke Terverifikasi.
Langkah 4 - Aktifkan provider
Bagian berjudul “Langkah 4 - Aktifkan provider”Setelah verifikasi DNS, klik Aktifkan. Status provider menjadi Aktif. Hanya Aktif provider digunakan selama alur login SSO.
Anda dapat memilih Nonaktifkan di dashboard kapan saja. Itu memindahkan provider ke Nonaktif, yang menjeda SSO untuk domain tersebut tanpa menghapus konfigurasinya.
Langkah 5 - Tes dan tetapkan role
Bagian berjudul “Langkah 5 - Uji dan tetapkan peran”Ketika pengguna masuk via SSO untuk pertama kali dan tidak memiliki keanggotaan yang ada di organisasi tersebut, Capgo membuatkan akun mereka dengan baca role.
Setelah user pilot login:
- Buka Pengaturan → Organisasi → Anggota
- Cari tiap user yang di-provision via SSO
- Sesuaikan role mereka ke level yang sesuai (Unggah, Tulis, Admin, dll.)
Lihat rincian lengkap permission tentang apa yang bisa dilakukan setiap peran.
Opsional - Wajibkan SSO
Bagian berjudul “Opsional - Wajibkan SSO”Di Aktif provider, Anda dapat mengaktifkan Terapkan SSO. Saat diaktifkan, Capgo menandai pengguna autentikasi yang ada untuk domain email tersebut sebagai khusus SSO, dan alur login memerlukan autentikasi IdP untuk domain tersebut. Mengatur penyedia ke Nonaktif (Nonaktifkan) atau mematikan enforcement akan menghapus flag SSO-only untuk domain tersebut.
Referensi status provider
Bagian berjudul “Referensi status provider”| Status | Arti |
|---|---|
| Menunggu verifikasi | DNS TXT record belum diverifikasi |
| Terverifikasi | Kepemilikan domain terkonfirmasi; siap diaktifkan |
| Aktif | SSO sudah aktif untuk domain ini |
| Nonaktif | Diatur oleh Nonaktifkan di dashboard; SSO tidak digunakan untuk domain tersebut; gunakan Aktifkan kembali untuk kembali ke Aktif |
Checklist rollout
Bagian berjudul “Checklist rollout”- Paket Enterprise dikonfirmasi
- Aplikasi SAML dibuat di IdP dengan ACS URL dan Entity ID dari Capgo
- IdP dikonfigurasi untuk mengirim email claim yang stabil
- DNS TXT record telah dipublikasikan dan Verifikasi DNS berhasil
- Provider diaktifkan
- Pengguna pilot berhasil login
- Role ditingkatkan dari default baca sesuai kebutuhan
- Keputusan enforcement diambil (dan dikomunikasikan jika diaktifkan)
Dokumentasi terkait
Bagian berjudul “Dokumentasi terkait”Lanjutkan dari SSO (Enterprise)
Bagian berjudul “Lanjutkan dari SSO (Enterprise)”Jika Anda menggunakan SSO (Enterprise) untuk merencanakan alur autentikasi dan akun, hubungkan dengan @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric, Autentikasi dua faktor untuk detail implementasi pada Two-factor authentication, dan 5 Langkah Implementasi OAuth2 di Aplikasi Capacitor untuk konteks praktis dalam 5 Langkah Implementasi OAuth2 di Aplikasi Capacitor.