Menyiapkan OIDC SSO

OIDC adalah alternatif SAML untuk menghubungkan identity provider Anda. Keduanya memungkinkan tim masuk dengan akun perusahaan yang sudah mereka gunakan; OIDC adalah protokol yang lebih modern dan disukai beberapa provider. Jika Anda tidak yakin harus memakai yang mana, gunakan SAML. Itu default dan bekerja dengan setiap provider yang didukung. Pilih OIDC saat provider merekomendasikannya atau saat SAML bukan opsi untuk Anda.

Setup-nya berbentuk sama seperti SAML: konfigurasi, verifikasi domain, uji, lalu nyalakan, dengan beberapa detail khusus OIDC.

Sebelum memulai

  • Akun admin dengan izin mengelola single sign-on.
  • Akses ke admin console identity provider Anda.
  • Domain yang dapat diverifikasi (domain email yang dipakai tim untuk masuk).

Buka wizard setup

  1. Buka User Management → Single Sign-On.
  2. Pilih Set up single sign-on.
  3. Pilih provider Anda, lalu ubah protokol ke OIDC.

Tukar pengaturan dengan identity provider

  1. Buat aplikasi OIDC baru (atau "OpenID Connect") di console provider. Kliv menampilkan redirect URL yang perlu ditempelkan.

  2. Provider memberi Anda client ID, client secret, dan issuer URL (alamat web yang mengidentifikasi layanan login provider). Tempelkan ketiganya ke Kliv.

  3. Issuer URL harus cocok dengan provider Anda persis, karakter demi karakter. Ini hal yang paling sering salah:

    • Issuer Microsoft Entra spesifik untuk tenant Anda dan menyertakan identifier panjang. Salin dari aplikasi Anda sendiri, jangan pakai ulang dari panduan.
    • Google menerbitkan issuer dalam lebih dari satu bentuk; gunakan yang persis ditampilkan console Anda.

    Jika issuer sedikit saja meleset, sign-in valid akan ditolak. Langkah test di bawah akan memberi tahu jika ini masalahnya.

Kliv menyimpan ini sebagai draft: terkonfigurasi tetapi belum live. Tim Anda tetap masuk dengan cara yang mereka pakai hari ini sampai Anda selesai.

Verifikasi domain Anda

Seperti SAML, Kliv tidak akan membuat akun dari provider sampai Anda membuktikan bahwa Anda mengontrol domain email. Ikuti Verifikasi domain Anda, lalu kembali ke sini setelah tampil Verified.

Uji dengan sign-in nyata

  1. Pilih Test login.
  2. Masuk di provider persis seperti yang akan dilakukan tim.
  3. Jika berhasil, Kliv mencatat test dan membuka Turn on.
  4. Jika gagal, Kliv menampilkan detail expected-versus-received agar Anda dapat memperbaiki issuer, secret, atau redirect. Lihat Memecahkan masalah login SSO yang gagal.

Nyalakan

Setelah test sign-in berhasil, pilih Turn on. Orang pada domain terverifikasi Anda sekarang dikirim ke provider untuk masuk, dan sign-in pertama kali membuat akun anggota standar secara otomatis.

Anggota baru hanya mendapat akses member, tidak ada role tinggi kecuali Anda mengonfigurasi group mapping.

Catatan tentang identitas pengguna

OIDC mengidentifikasi setiap orang dengan pasangan nilai stabil dari provider Anda, bukan dengan alamat email. Ini disengaja: artinya seseorang tetap memiliki akun Kliv yang sama meski email berubah, dan Kliv tidak bergantung pada provider yang menandai email sebagai "verified" (beberapa provider tidak mengirim itu untuk akun kerja). Anda tidak perlu mengonfigurasi apa pun untuk ini. Ini hanya berguna untuk mengetahui mengapa email yang berubah tidak membuat akun duplikat.