设置 OIDC SSO
OIDC 是连接身份提供商时可替代 SAML 的方式。两者都能让你的团队使用现有公司账户登录;OIDC 是较新的协议,有些提供商更偏好它。如果你不确定该用哪一个,请使用 SAML;它是默认选择,并且适用于每个受支持的提供商。当你的提供商建议使用 OIDC,或 SAML 对你不可用时,再选择 OIDC。
设置流程与 SAML 的结构相同:配置、验证域名、测试,然后启用;只是有几个 OIDC 专属细节。
开始之前
- 一个有权管理单点登录的管理员账户。
- 可以访问身份提供商的管理控制台。
- 一个可以验证的域名(你的团队用于登录的邮箱域名)。
打开设置向导
- 前往用户管理 → 单点登录。
- 选择设置单点登录。
- 选择你的提供商,然后将协议切换为 OIDC。
与身份提供商交换设置
-
在提供商控制台中创建一个新的 OIDC(或“OpenID Connect”)应用。Kliv 会显示需要粘贴进去的重定向 URL。
-
你的提供商会给你一个客户端 ID、一个客户端密钥和一个颁发者 URL(标识提供商登录服务的网址)。将三者都粘贴到 Kliv。
-
颁发者 URL 必须与你的提供商完全一致,逐字符匹配。这是最常出错的地方:
- Microsoft Entra 的颁发者与你的租户相关,并包含一个长标识符;请从你自己的应用中复制,不要复用指南里的值。
- Google 会以多种形式发布其颁发者;请使用控制台显示的确切值。
只要颁发者有一点偏差,有效登录也会被拒绝。下面的测试步骤会告诉你问题是否在这里。
Kliv 会将此保存为草稿;配置已经存在,但尚未生效。在你完成之前,团队仍会按今天的方式登录。
验证你的域名
与 SAML 一样,Kliv 不会从你的提供商创建账户,直到你证明自己控制该邮箱域名。按照验证你的域名操作,等它显示已验证后再回到这里。
使用真实登录进行测试
- 选择测试登录。
- 在你的提供商处登录,方式与团队之后登录时完全相同。
- 成功后,Kliv 会记录测试并解锁启用。
- 失败时,Kliv 会显示预期与实际收到内容的详情,方便你修复颁发者、密钥或重定向;参见排查失败的 SSO 登录。
启用
测试登录成功后,选择启用。已验证域名上的用户现在会被发送到你的提供商登录,首次登录会自动创建一个标准成员账户。
新成员只会获得成员访问权;除非你配置群组映射,否则不会获得提升后的角色。
关于用户身份的说明
OIDC 通过来自提供商的一对稳定值来识别每个人,而不是通过邮箱地址。这样做是有意的:这意味着即使某人的邮箱发生变化,也会保留同一个 Kliv 账户;也意味着 Kliv 不依赖你的提供商将邮箱标记为“已验证”(有些提供商不会为工作账户发送该标记)。你不需要为此配置任何内容;知道为什么邮箱变化不会创建重复账户即可。