Menyiapkan SAML SSO
Single sign-on (SSO) memungkinkan tim masuk ke Kliv dengan akun yang sudah mereka gunakan di tempat kerja, melalui identity provider perusahaan (layanan yang mengelola login karyawan, seperti Okta atau Microsoft Entra). Tidak ada kata sandi Kliv terpisah untuk dikelola, dan saat seseorang pergi, menghapusnya di satu tempat juga menghapus aksesnya di sini.
SAML adalah cara paling luas didukung untuk menghubungkan identity provider. Halaman ini memandu Anda menyiapkannya, mengujinya dengan sign-in nyata, dan menyalakannya, dalam urutan itu, agar tidak ada yang rusak untuk tim.
Anda mengonfigurasi semua ini sendiri. Tidak ada tiket dukungan dan tidak ada panggilan vendor.
Sebelum memulai
- Anda membutuhkan akun admin dengan izin mengelola single sign-on untuk organisasi.
- Anda membutuhkan akses ke admin console identity provider (Okta, Entra, Google Workspace, OneLogin, atau provider SAML lain).
- Siapkan domain yang dapat diverifikasi, yaitu domain email yang dipakai tim untuk masuk (misalnya
yourcompany.com).
Buka wizard setup
- Buka User Management → Single Sign-On.
- Pilih Set up single sign-on.
- Pilih provider Anda: Okta, Microsoft Entra, Google, OneLogin, atau Other. Memilih provider dikenal mengisi pengaturan yang tepat sebelumnya sehingga lebih sedikit yang perlu Anda salin manual.
- Biarkan protokol pada SAML (default). OIDC adalah alternatif lanjutan. Lihat Menyiapkan OIDC SSO.
Tukar pengaturan dengan identity provider
SSO bekerja karena identity provider Anda dan Kliv saling percaya. Anda memberi masing-masing beberapa detail tentang yang lain:
- Kliv menampilkan nilai yang dibutuhkan provider (seperti sign-in URL yang didengarkan Kliv). Salin ini ke aplikasi SAML baru di admin console provider.
- Provider memberi Anda detailnya sendiri, biasanya metadata URL atau file XML, plus sertifikat signing. Tempelkan metadata (atau unggah file) ke Kliv.
- Pastikan provider mengirim identifier stabil untuk setiap pengguna, bukan hanya alamat email. (Atribut persisnya spesifik provider. Preset menyebut nama yang harus dipakai; konfirmasi wording di console Anda.) Ini nilai yang digunakan Kliv untuk mengenali orang yang kembali meski email berubah.
Kliv menyimpan ini sebagai draft. Draft terkonfigurasi tetapi belum live. Tim Anda tetap masuk dengan cara yang mereka pakai hari ini sampai Anda selesai.
Verifikasi domain Anda
Sebelum Kliv membuat akun dari provider, Anda harus membuktikan bahwa Anda mengontrol domain email yang dipakai tim. Ini mencegah siapa pun mengklaim domain yang bukan miliknya.
Ikuti Verifikasi domain Anda untuk menambahkan DNS record atau file ke situs web. Kembali ke sini setelah tampil Verified.
Uji dengan sign-in nyata
Ini langkah yang membuat SSO aman dinyalakan: Anda membuktikan seluruh round-trip bekerja sebelum memengaruhi siapa pun.
- Di wizard, pilih Test login.
- Anda akan dikirim ke identity provider untuk masuk, persis seperti tim Anda nanti.
- Jika berhasil, Kliv mencatat test yang berhasil dan membuka tombol Turn on.
- Jika gagal, Kliv menampilkan apa yang diharapkan dibandingkan apa yang benar-benar dikirim provider. Lihat Memecahkan masalah login SSO yang gagal. Perbaiki di provider dan uji lagi.
Anda tidak dapat menyalakan SSO sampai test sign-in berhasil terhadap konfigurasi persis yang akan Anda aktifkan. Sekadar menyimpan tidak pernah cukup.
Nyalakan
Setelah test lulus, pilih Turn on. Mulai sekarang, saat seseorang memasukkan alamat email pada domain terverifikasi Anda, Kliv mengirim mereka ke identity provider untuk masuk. Orang yang masuk pertama kali mendapat akun Kliv dibuat otomatis, dengan akses anggota standar.
Anggota baru masuk ke everyone-group saja. Mereka tidak mendapat admin atau role tinggi apa pun dari identity provider kecuali Anda menyiapkannya dengan sengaja. Lihat Petakan grup IdP ke role Kliv.
Setelah setup
Halaman Single Sign-On kini menampilkan status card, bukan wizard: provider Anda, domain terverifikasi, sign-in berhasil terakhir, dan peringatan jika sertifikat signing mendekati kedaluwarsa. Perhatikan peringatan itu. Sertifikat kedaluwarsa menghentikan sign-in sampai Anda mengunggah yang baru.
Untuk mewajibkan semua orang di domain memakai SSO (dan mempertahankan jalan masuk aman jika pernah rusak), lihat Wajibkan SSO dan tetapkan admin break-glass.