设置 SAML SSO

单点登录(SSO)让你的团队可以通过公司的身份提供商(管理员工登录的服务,例如 Okta 或 Microsoft Entra),使用他们已经在工作中使用的账户登录 Kliv。无需管理单独的 Kliv 密码;当有人离职时,在一个地方移除他们,也会移除他们在这里的访问权。

SAML 是连接身份提供商时支持最广泛的方式。本页会按顺序带你完成设置、用真实登录测试,以及启用;按这个顺序操作,团队才不会受到影响。

你可以自行完成所有这些配置。不需要支持工单,也不需要供应商通话。

开始之前

  • 你需要一个有权为组织管理单点登录的管理员账户。
  • 你需要能够访问身份提供商的管理控制台(Okta、Entra、Google Workspace、OneLogin,或其他 SAML 提供商)。
  • 准备一个可以验证的域名,也就是你的团队用于登录的邮箱域名(例如 yourcompany.com)。

打开设置向导

  1. 前往用户管理 → 单点登录。
  2. 选择设置单点登录。
  3. 选择你的提供商:Okta、Microsoft Entra、Google、OneLogin 或其他。选择已知提供商会预填正确设置,让你需要手动复制的内容更少。
  4. 将协议保留为 SAML(默认值)。OIDC 是高级替代方案;参见设置 OIDC SSO。

与身份提供商交换设置

SSO 的工作方式是让你的身份提供商和 Kliv 互相信任。你需要给双方各提供关于对方的几个细节:

  1. Kliv 会显示你的提供商需要的值(例如 Kliv 监听的登录 URL)。将这些值复制到提供商管理控制台中的新 SAML 应用里。
  2. 你的提供商会返回自己的详情,通常是一个元数据 URL 或一个 XML 文件,外加一个签名证书。将元数据粘贴到 Kliv(或上传文件)。
  3. 确保你的提供商为每个用户发送的是稳定标识符,而不只是邮箱地址。(具体属性因提供商而异;预设会命名要使用的属性,请在控制台中确认措辞。) 这是 Kliv 用来识别回访用户的值,即使他们的邮箱发生变化也能识别。

Kliv 会将此保存为草稿。草稿表示已经配置,但尚未生效;在你完成之前,团队仍会按今天的方式登录。

验证你的域名

在 Kliv 从你的提供商创建账户之前,你必须证明自己控制团队使用的邮箱域名。这样可以防止任何人认领不属于自己的域名。

按照验证你的域名添加 DNS 记录,或向你的网站添加一个文件。等它显示已验证后再回到这里。

使用真实登录进行测试

这一步让 SSO 可以安全启用:你会在它影响任何人之前,证明完整往返流程可以工作。

  1. 在向导中选择测试登录。
  2. 系统会将你发送到身份提供商进行登录,方式与团队之后登录时完全相同。
  3. 如果成功,Kliv 会记录这次成功测试,并解锁启用按钮。
  4. 如果失败,Kliv 会显示它预期收到什么,以及你的提供商实际发送了什么;参见排查失败的 SSO 登录。在提供商中修复后再次测试。

你必须使用即将激活的确切配置完成一次成功测试登录,才能启用 SSO。单纯保存永远不够。

启用

测试通过后,选择启用。从现在开始,当有人输入已验证域名上的邮箱地址时,Kliv 会将他们发送到你的身份提供商登录。首次登录的用户会自动创建 Kliv 账户,并获得标准成员访问权。

新成员只会进入你的所有人群组。除非你有意设置,否则他们不会从身份提供商获得管理员或任何提升后的角色;参见将 IdP 群组映射到 Kliv 角色。

设置后

你的单点登录页面现在会显示状态卡,而不是向导:其中包含你的提供商、已验证域名、上次成功登录,以及签名证书即将过期时的警告。请留意该警告;证书过期会阻止登录,直到你上传新的证书。

若要强制你的域名下的所有人都使用 SSO(并保留一种在 SSO 出问题时安全进入的方式),请参见要求使用 SSO 并设置应急管理员。