Memecahkan Masalah Login SSO yang Gagal

Saat sign-in melalui identity provider tidak bekerja, Kliv dibangun untuk memberi tahu perbaikan sebenarnya, bukan hanya "sign-in failed." Halaman ini menunjukkan ke mana melihat dan cara membaca yang Anda temukan.

Di mana jawabannya berada

Ada dua tampilan berbeda untuk sign-in gagal, dengan sengaja:

  • Orang yang masuk melihat pesan sederhana "we couldn't sign you in" dengan reference ID singkat. Mereka tidak melihat detail teknis, karena itu akan membocorkan cara konfigurasi identitas Anda.
  • Anda, admin, melihat diagnosis lengkap di log audit. Di sanalah reference ID menunjuk.

Jadi saat rekan tim melaporkan sign-in gagal, minta reference ID, lalu cari.

Baca diagnosis

  1. Buka User Management → Single Sign-On dan buka tab Audit.
  2. Temukan sign-in gagal (cocokkan reference ID, atau lihat entri terbaru).
  3. Buka untuk melihat detail expected-versus-received: untuk setiap check yang dijalankan Kliv, apa yang diharapkan dan apa yang benar-benar dikirim provider. Ketidakcocokan itulah perbaikannya.

Anda dapat menjalankan langkah Test login di halaman Single Sign-On untuk mereproduksi kegagalan sesuai kebutuhan saat mengerjakannya, tanpa melibatkan pengguna nyata.

Penyebab umum dan perbaikan

Issuer tidak cocok (OIDC). Masalah OIDC paling sering. Issuer URL harus cocok dengan provider karakter demi karakter. Issuer Microsoft Entra spesifik untuk tenant Anda; Google menerbitkan lebih dari satu bentuk. Salin issuer persis dari aplikasi provider Anda sendiri dan tempelkan ke Kliv.

Sertifikat signing kedaluwarsa (SAML). Sign-in yang kemarin bekerja tiba-tiba gagal. Sertifikat signing provider Anda kedaluwarsa. Unggah sertifikat saat ini (atau refresh dari metadata provider). Status card memperingatkan sebelum ini terjadi. Perhatikan.

Domain email pengguna belum diverifikasi. Kliv hanya membuat akun untuk domain email yang sudah Anda buktikan Anda kontrol. Jika sign-in ditolak karena domain belum diverifikasi, selesaikan Verifikasi domain Anda untuk domain tersebut.

Akun dinonaktifkan. Jika orang itu dinonaktifkan di identity provider atau di Kliv, sign-in ditolak sesuai desain. Login SSO tidak pernah diam-diam mengaktifkan ulang akun yang dinonaktifkan. Aktifkan ulang di provider jika mereka seharusnya punya akses.

Identitas (NameID) tidak stabil. Jika provider mengirim identifier berbeda setiap kali, atau mengirim email alih-alih ID stabil, Kliv tidak dapat mengenali orang yang sama dengan andal. Konfigurasikan provider untuk mengirim identifier stabil yang ditentukan preset untuknya.

Email tidak ditandai "verified." Kliv tidak membutuhkan ini. Kliv mengidentifikasi orang berdasarkan identifier provider yang stabil, bukan flag email-verified, jadi tanda "verified" yang hilang bukan penyebabnya. Lihat check lain sebagai gantinya.

Jika Anda masih buntu

Detail expected-versus-received menyebut check spesifik yang gagal dan menawarkan panduan sadar-provider. Kerjakan check itu, perbaiki di provider, lalu jalankan ulang Test login. Karena aktivasi membutuhkan test berhasil, konfigurasi yang sebelumnya bekerja lalu tiba-tiba berhenti hampir selalu berarti sertifikat kedaluwarsa atau pengaturan berubah di sisi provider.