SSO (Enterprise)

Peringatan

Pengaturan SSO tersedia hanya pada rencana Enterprise. Jika Anda tidak melihat Pengaturan SSO di bawah Pengaturan → Organisasi → Keamanan, pastikan organisasi Anda berada pada rencana Enterprise atau hubungi kontak Capgo Anda.

Apa itu SSO?

Pengenalan Satu Tanda Masuk (SSO) memungkinkan tim Anda masuk ke Capgo menggunakan penyedia identitas perusahaan (IdP) Anda. Capgo menggunakan SAML 2.0 melalui Supabase Auth. Ketika domain email pengguna cocok dengan penyedia SSO aktif, mereka dapat mengautentikasi terhadap IdP Anda dan diberi akses ke organisasi selama panggilan balik SSO.

SSO tidak mengubah apa yang dapat dilakukan pengguna. Izin diatur oleh peran organisasi. Hanya SSO yang mengubah cara mereka masuk.

Prasyarat

Sebelum memulai:

• Langganan Enterprise aktif pada organisasi Capgo.
• Sebuah penyedia identitas yang mendukung SAML 2.0 dan mengungkapkan URL metadata IdP (HTTPS). Kemampuan untuk mempublikasikan
• a Rekaman TXT DNS untuk domain email (misalnya company.com untuk pengguna yang masuk sebagai user@company.com).
• Seorang anggota organisasi Capgo dengan izin untuk memperbarui pengaturan organisasi.
• Suatu Admin IdP kontak di sisi IT/keamanan.

Di mana untuk menemukan pengaturan SSO

1. Buka https://console.capgo.app/
2. Klik Pengaturan di sidebar kiri
3. Pilih tab Organisasi Pilih tab
4. Keamanan Luncurkan ke Konfigurasi SSO
5. . Form ini hanya tersedia ketika organisasi berlangganan Enterprise plan. Langkah 1 - Konfigurasi IdP Anda__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

Di penyedia identitas Anda, buatlah aplikasi SAML 2.0 baru. Anda akan membutuhkan informasi berikut Pemberi Layanan nilai-nilai yang ditampilkan di panel konfigurasi SSO Capgo:

Bidang	Di mana untuk menggunakannya
URL Konsumen Asertasi	URL Konsumen Asertasi Layanan di aplikasi SAML IdP Anda
ID Entitas	Identifikasi Entitas Pemberi Layanan
URL Metadata SP	Opsional: import jika penyedia IdP Anda mendukung import metadata SP melalui URL
Format Nama Pengguna ID	Format yang diharapkan untuk Pengidentifikasi Nama Pengguna SAML

IDP Anda harus melepaskan alamat email pengguna pada klaim. __CAPGO_KEEP_0__ menggunakan domain email untuk menentukan penyedia SSO aktif dan untuk mencocokkan akun yang sudah ada. Langkah 2 - Tambahkan penyedia SSO di Capgo

Bagian berjudul “Langkah 2 - Tambahkan penyedia SSO di Capgo”

1. Masukkan
2. domain email (misalnya, ). Harus sesuai dengan bagian domain alamat email sign-in pengguna Anda In the SSO configuration panel, click to add a new provider company.comEnter the
3. Masukkan IDP Anda URL metadata (HTTPS)
4. Kirim

Provider dibuat dengan status Tunggu verifikasi.

Langkah 3 - Verifikasi domain DNS

Capgo memastikan Anda mengontrol domain sebelum SSO dapat aktif.

Tambahkan rekam TXT di penyedia DNS Anda:

Bidang	Nilai
Tipe	TXT
Nama / host	_capgo-sso.<your-domain> (misalnya _capgo-sso.company.com)
Nilai	Token verifikasi yang ditampilkan di panel dashboard

Setelah rekaman dipublikasikan (propagasi TTL DNS biasanya membutuhkan beberapa menit hingga satu jam), klik Verifikasi DNS di dashboard. Setelah berhasil, penyedia berpindah ke Terverifikasi.

Langkah 4 - Aktifkan penyedia

Setelah verifikasi DNS, klik Aktifkan. Status penyedia menjadi Aktif. Hanya penyedia yang aktif yang digunakan selama alur login SSO. Anda dapat memilih Nonaktifkan

di dashboard kapan saja. Itu akan mengaktifkan penyedia ke Diblokir __CAPGO_KEEP_0__ __CAPGO_KEEP_0__yang menghentikan SSO untuk domain tersebut tanpa menghapus konfigurasi.

Langkah 5 - Uji dan asingkan peran

Ketika pengguna masuk melalui SSO untuk pertama kalinya dan tidak memiliki anggota yang ada di organisasi tersebut, Capgo memberikan mereka dengan baca peran.

Setelah pengguna pilot masuk:

1. Pergi ke Pengaturan → Organisasi → Anggota
2. Cari setiap pengguna yang disediakan oleh SSO
3. Ubah peran mereka ke tingkat yang sesuai (Upload, Tulis, Admindan lain-lain)

Lihat detail pengaturan hak akses untuk mengetahui apa yang dapat dilakukan oleh setiap peran. Catatan Catatan

Opsional - Enforce SSO

If Supabase creates a separate SSO auth user for an email that already exists in Capgo, Capgo merges the SSO identity into the existing account and asks the user to sign in again.

Pada

On an Aktif penyedia yang dapat diaktifkan/tidak aktif Tegakkan SSO. Ketika diaktifkan, Capgo menandai pengguna autentikasi yang ada untuk domain email sebagai SSO-saja dan alur login memerlukan autentikasi IdP untuk domain tersebut. Mengatur penyedia ke Dinonaktifkan (Nonaktifkan) atau menghentikan penegakan menghapus tanda SSO-saja untuk domain.

Peringatan

Koordinasikan dengan admin IdP Anda dan peringatkan semua pengguna yang terkena sebelum mengaktifkan penegakan. Pengguna yang tidak dapat menyelesaikan autentikasi IdP tidak akan dapat masuk dengan kata sandi untuk domain tersebut.

Referensi status penyedia

Status	Arti
Menunggu verifikasi	DNS TXT record belum diverifikasi
Diverifikasi	Pemilik domain dikonfirmasi; siap untuk diaktifkan
Aktif	SSO aktif untuk domain ini
Diblokir	Ditetapkan oleh Nonaktifkan di dashboard; SSO tidak digunakan untuk domain tersebut; gunakan Aktifkan ulang untuk kembali ke Aktif

Daftar checklist peluncuran

• Konfirmasi rencana bisnis
• Aplikasi SAML dibuat di IdP dengan URL ACS dan ID Entitas dari Capgo
• IdP dikonfigurasi untuk melepaskan klaim email stabil
• Catatan TXT DNS dipublikasikan dan Verifikasi DNS berhasil
• Pemberi aktifkan
• Pengguna pilot masuk dengan sukses
• Peran ditingkatkan dari default baca sebagaimana diperlukan
• Keputusan pelaksanaan dibuat (dan disampaikan jika diaktifkan)

Dokumentasi terkait

• Organisasi: peran dan izin
• Keamanan organisasi: 2FA, kata sandi, API kunci

Lanjutkan dari SSO (Enterprise)

Jika Anda menggunakan SSO (Enterprise) untuk merencanakan autentikasi dan alur akun, hubungkannya dengan @capgo/capacitor-login-sosial untuk detail implementasi di @capgo/capacitor-login-sosial, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-biometrik-native untuk detail implementasi di @capgo/capacitor-biometrik-native, Autentikasi Dua Faktor untuk detail implementasi di Autentikasi Dua Faktor, dan 5 Langkah untuk Mengimplementasikan OAuth2 di Aplikasi Capacitor untuk konteks praktis di 5 Langkah untuk Mengimplementasikan OAuth2 di Aplikasi Capacitor.