设置 SAML SSO
单点登录(SSO)让你的团队可以通过公司的身份提供商(管理员工登录的服务,例如 Okta 或 Microsoft Entra),使用他们已经在工作中使用的账户登录 Kliv。无需管理单独的 Kliv 密码;当有人离职时,在一个地方移除他们,也会移除他们在这里的访问权。
SAML 是连接身份提供商时支持最广泛的方式。本页会按顺序带你完成设置、用真实登录测试,以及启用;按这个顺序操作,团队才不会受到影响。
你可以自行完成所有这些配置。不需要支持工单,也不需要供应商通话。
开始之前
- 你需要一个有权为组织管理单点登录的管理员账户。
- 你需要能够访问身份提供商的管理控制台(Okta、Entra、Google Workspace、OneLogin,或其他 SAML 提供商)。
- 准备一个可以验证的域名,也就是你的团队用于登录的邮箱域名(例如
yourcompany.com)。
打开设置向导
- 前往用户管理 → 单点登录。
- 选择设置单点登录。
- 选择你的提供商:Okta、Microsoft Entra、Google、OneLogin 或其他。选择已知提供商会预填正确设置,让你需要手动复制的内容更少。
- 将协议保留为 SAML(默认值)。OIDC 是高级替代方案;参见设置 OIDC SSO。
与身份提供商交换设置
SSO 的工作方式是让你的身份提供商和 Kliv 互相信任。你需要给双方各提供关于对方的几个细节:
- Kliv 会显示你的提供商需要的值(例如 Kliv 监听的登录 URL)。将这些值复制到提供商管理控制台中的新 SAML 应用里。
- 你的提供商会返回自己的详情,通常是一个元数据 URL 或一个 XML 文件,外加一个签名证书。将元数据粘贴到 Kliv(或上传文件)。
- 确保你的提供商为每个用户发送的是稳定标识符,而不只是邮箱地址。(具体属性因提供商而异;预设会命名要使用的属性,请在控制台中确认措辞。) 这是 Kliv 用来识别回访用户的值,即使他们的邮箱发生变化也能识别。
Kliv 会将此保存为草稿。草稿表示已经配置,但尚未生效;在你完成之前,团队仍会按今天的方式登录。
验证你的域名
在 Kliv 从你的提供商创建账户之前,你必须证明自己控制团队使用的邮箱域名。这样可以防止任何人认领不属于自己的域名。
按照验证你的域名添加 DNS 记录,或向你的网站添加一个文件。等它显示已验证后再回到这里。
使用真实登录进行测试
这一步让 SSO 可以安全启用:你会在它影响任何人之前,证明完整往返流程可以工作。
- 在向导中选择测试登录。
- 系统会将你发送到身份提供商进行登录,方式与团队之后登录时完全相同。
- 如果成功,Kliv 会记录这次成功测试,并解锁启用按钮。
- 如果失败,Kliv 会显示它预期收到什么,以及你的提供商实际发送了什么;参见排查失败的 SSO 登录。在提供商中修复后再次测试。
你必须使用即将激活的确切配置完成一次成功测试登录,才能启用 SSO。单纯保存永远不够。
启用
测试通过后,选择启用。从现在开始,当有人输入已验证域名上的邮箱地址时,Kliv 会将他们发送到你的身份提供商登录。首次登录的用户会自动创建 Kliv 账户,并获得标准成员访问权。
新成员只会进入你的所有人群组。除非你有意设置,否则他们不会从身份提供商获得管理员或任何提升后的角色;参见将 IdP 群组映射到 Kliv 角色。
设置后
你的单点登录页面现在会显示状态卡,而不是向导:其中包含你的提供商、已验证域名、上次成功登录,以及签名证书即将过期时的警告。请留意该警告;证书过期会阻止登录,直到你上传新的证书。
若要强制你的域名下的所有人都使用 SSO(并保留一种在 SSO 出问题时安全进入的方式),请参见要求使用 SSO 并设置应急管理员。