Langsung ke konten

SSO (Enterprise)

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.

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.com untuk pengguna yang login sebagai user@company.com).
  • Anggota organisasi Capgo dengan izin untuk memperbarui pengaturan organisasi.
  • Sebuah admin IdP di sisi IT/keamanan Anda.
  1. Buka https://console.capgo.app/
  2. Klik Pengaturan di bilah sisi kiri
  3. Pilih Organisasi tab
  4. Pilih Keamanan tab
  5. Gulir ke Konfigurasi SSO. Formulir ini hanya tersedia jika organisasi menggunakan paket Enterprise.

Di identity provider Anda, buat aplikasi SAML 2.0 baru. Anda akan membutuhkan Penyedia Layanan nilai yang ditampilkan di panel konfigurasi SSO Capgo:

KolomDi mana digunakan
URL ACSAssertion Consumer Service URL di aplikasi SAML IdP Anda
ID EntitasPengenal entitas Service Provider
URL metadata SPOpsional: impor jika IdP Anda mendukung impor metadata SP via URL
Format NameIDFormat 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.

  1. Di panel konfigurasi SSO, klik untuk menambah provider baru
  2. Masukkan domain email (mis. company.com). Harus cocok dengan bagian domain email login pengguna Anda
  3. Masukkan IdP Anda URL metadata (HTTPS)
  4. Kirim

Provider dibuat dengan status Menunggu verifikasi.

Capgo memverifikasi bahwa Anda mengontrol domain sebelum SSO dapat diaktifkan.

Tambahkan TXT record di penyedia DNS Anda:

KolomNilai
TipeTXT
Nama / host_capgo-sso.<your-domain> (mis. _capgo-sso.company.com)
NilaiToken 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.

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.

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:

  1. Buka Pengaturan → Organisasi → Anggota
  2. Cari tiap user yang di-provision via SSO
  3. Sesuaikan role mereka ke level yang sesuai (Unggah, Tulis, Admin, dll.)

Lihat rincian lengkap permission tentang apa yang bisa dilakukan setiap peran.

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.

StatusArti
Menunggu verifikasiDNS TXT record belum diverifikasi
TerverifikasiKepemilikan domain terkonfirmasi; siap diaktifkan
AktifSSO sudah aktif untuk domain ini
NonaktifDiatur oleh Nonaktifkan di dashboard; SSO tidak digunakan untuk domain tersebut; gunakan Aktifkan kembali untuk kembali ke Aktif
  • 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)

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.