排解 SSO 登入失敗

透過身分提供者登入失敗時,Kliv 的設計是要告訴你真正的解決方法,而不只是「登入失敗」。本頁說明該去哪裡找,以及如何解讀你找到的內容。

答案在哪裡

針對登入失敗,刻意提供兩種不同的檢視:

  • 登入的人會看到一則簡單的「我們無法讓你登入」訊息,並附上簡短的參考 ID。他們看不到技術細節,因為那會洩漏你的身分設定方式。
  • 身為管理員的你,可以在稽核記錄中看到完整的診斷。參考 ID 指向的就是那裡。

所以當同事回報登入失敗時,請向他們索取參考 ID,再去查詢。

解讀診斷結果

  1. 前往使用者管理 → 單一登入,開啟稽核分頁。
  2. 找到失敗的登入(比對參考 ID,或直接看最新的項目)。
  3. 開啟它查看預期與實際收到的明細:Kliv 執行的每項檢查,它預期什麼,以及提供者實際傳來什麼。兩者的差異就是你要修正的地方。

你可以在單一登入頁面執行測試登入步驟,在處理問題的同時隨時重現失敗,不必牽涉真實使用者。

常見原因與解決方法

issuer 不符(OIDC)。 最常見的 OIDC 問題。issuer URL 必須與你的提供者一字不差。Microsoft Entra 的 issuer 是各租戶專屬的;Google 則公布了不只一種形式。請從你自己的提供者應用程式複製確切的 issuer,貼到 Kliv 中。

簽署憑證已過期(SAML)。 昨天還正常的登入突然失敗,是因為提供者的簽署憑證已失效。請上傳目前的憑證(或從提供者的中繼資料重新整理)。狀態卡片會在這種情況發生之前警告你,請多加留意。

使用者的電子郵件網域尚未驗證。 Kliv 只會為你已證明掌控的電子郵件網域建立帳戶。如果登入因網域未驗證而被拒絕,請針對該網域完成驗證你的網域。

帳戶已停用。 如果該使用者在身分提供者或 Kliv 中被停用,登入依設計會被拒絕,SSO 登入絕不會悄悄重新啟用已停用的帳戶。如果他們應該擁有存取權,請在你的提供者中重新啟用。

身分(NameID)不穩定。 如果提供者每次傳送不同的識別碼,或傳送的是電子郵件而不是穩定的 ID,Kliv 就無法可靠地辨識同一個人。請將提供者設定為傳送預設範本所指定的穩定識別碼。

電子郵件未標示為「已驗證」。 Kliv 並不要求這點,它是依提供者的穩定識別碼來辨識人員,而不是依電子郵件驗證標記,因此缺少「已驗證」標記不會是原因。請檢查其他項目。

如果仍然卡關

預期與實際收到的明細會指出失敗的具體檢查項目,並提供針對該提供者的指引。針對那一項檢查處理,在提供者端修正,然後重新執行測試登入。由於啟用時需要一次成功的測試,因此原本正常卻突然失效的設定,幾乎都是憑證過期,或提供者端有設定被變更。