排查失败的 SSO 登录

当通过身份提供商登录失败时,Kliv 会尽量告诉你真正需要修复什么,而不只是显示“登录失败”。本页说明去哪里查看,以及如何理解你看到的内容。

答案在哪里

失败登录有两个不同视图,这是有意设计:

  • 正在登录的人会看到一条简单的“我们无法让你登录”消息,以及一个简短的参考 ID。他们不会看到技术详情;否则会泄露你的身份配置方式。
  • 作为管理员的你会在审计日志中看到完整诊断。参考 ID 指向的就是那里。

因此,当队友报告登录失败时,请向他们索取参考 ID,然后查找它。

读取诊断

  1. 前往用户管理 → 单点登录,打开审计标签页。
  2. 找到失败的登录(匹配参考 ID,或直接查看最近的条目)。
  3. 打开它查看预期与实际收到详情:对于 Kliv 运行的每项检查,它预期收到什么,以及你的提供商实际发送了什么。两者不一致的地方就是你要修复的地方。

你可以在单点登录页面运行测试登录步骤,在处理问题时按需复现失败,而不需要牵涉真实用户。

常见原因和修复

颁发者不匹配(OIDC)。 这是最常见的 OIDC 问题。颁发者 URL 必须与你的提供商逐字符匹配。Microsoft Entra 的颁发者与你的租户相关;Google 会发布多种形式。请从你自己的提供商应用复制确切颁发者,并粘贴到 Kliv。

签名证书过期(SAML)。 昨天还能工作的登录突然失败。你的提供商签名证书已经过期。上传当前证书(或从提供商元数据刷新)。状态卡会在发生前提醒你;请留意它。

用户的邮箱域名未验证。 Kliv 只会为你已经证明自己控制的邮箱域名创建账户。如果某次登录因为域名未验证而被拒绝,请为该域名完成验证你的域名。

账户已停用。 如果该人员已在你的身份提供商或 Kliv 中停用,登录会按设计被拒绝;SSO 登录绝不会悄悄重新激活已停用账户。如果他们应有访问权,请在提供商中重新启用。

身份(NameID)不稳定。 如果你的提供商每次发送不同标识符,或发送邮箱而不是稳定 ID,Kliv 就无法可靠识别同一个人。请配置提供商发送预设为它指定的稳定标识符。

邮箱未标记为“已验证”。 Kliv 不要求这一点;它通过稳定的提供商标识符识别人,而不是通过邮箱已验证标记。因此缺少“已验证”标记不是原因。请改看其他检查。

如果你仍然卡住

预期与实际收到详情会命名失败的具体检查,并提供了解提供商差异的指导。集中处理这一项检查,在提供商中修复,然后重新运行测试登录。由于激活要求成功测试,如果某个配置之前能工作却突然停止,几乎总是因为证书过期,或你的提供商侧设置发生了变化。