配置 SCIM 预配

SCIM 预配会自动让 Kliv 中的团队成员与你的身份提供商保持同步。当你在 Okta 或 Entra 中把某人加入正确群组时,他们会获得一个 Kliv 账户。当你在那里停用他们时,他们的 Kliv 访问权会被撤销,并且立即生效,包括任何已打开的会话。不需要手动清理,也不会有人在离开后仍保留访问权。

这就是目录同步。它与 SSO 配合工作:SSO 负责用户如何登录;SCIM 负责他们的账户如何创建和移除。

你将设置什么

你会给身份提供商两样东西:一个基础 URL 和一个令牌;剩下的由它从自己的侧面完成。启用后,你不再在 Kliv 中管理单个用户;你的提供商是事实来源。

开启预配并获取详情

  1. 前往用户管理 → 单点登录。
  2. 打开预配标签页。
  3. Kliv 会显示提供商需要的基础 URL。复制它。
  4. 选择生成令牌。Kliv 只会显示一次 bearer 令牌;现在复制它,并存放在安全位置。出于安全考虑,Kliv 之后不会再次显示。

在你的身份提供商中连接

在提供商的管理控制台中,打开 Kliv 应用的预配设置,并粘贴:

  • 来自 Kliv 的基础 URL,以及
  • 你刚刚生成的令牌。

然后启用你需要的操作,通常包括创建用户、更新用户和停用用户;如果你使用群组同步,也一并启用。你的提供商通常会提供一个测试连接按钮;运行它以确认连接可用。

账户如何创建和移除

  • 创建 / 激活 —— 在提供商中分配给 Kliv 的用户会获得 Kliv 账户,并拥有标准成员访问权。
  • 更新 —— 姓名或其他属性变更会自动流转。
  • 停用 —— 当你在提供商中将用户设为非活跃时,他们的 Kliv 访问权会被撤销,已打开的会话会结束。他们无法再登录。
  • 删除 —— 完全移除用户是停用的永久版本。

通过 SCIM 预配的新成员只会获得成员访问权。除非你有意设置群组映射,否则他们不会从提供商继承管理员或任何提升后的角色。

轮换令牌

如果令牌可能已经暴露,或你的安全策略要求按计划轮换,请轮换令牌。

  1. 在预配标签页上,选择轮换令牌。
  2. 复制新令牌(只显示一次),并在你的身份提供商中更新它。

在你用新令牌更新提供商之前,预配会失败;因此请在可以立即将新值粘贴到提供商中时再轮换。

持续关注

预配标签页会显示连接健康状态和近期错误。如果你的提供商报告预配失败,请先检查这里;连接失败几乎总是因为令牌过期或不匹配,或者基础 URL 没有完整复制。

在 Kliv 中管理 SCIM 用户

一旦某个用户或群组由 SCIM 所有,就由你的身份提供商负责。如果你尝试直接在 Kliv 中编辑由 SCIM 管理的用户或群组并被拒绝,这是预期行为;它是在保护你的提供商不被覆盖,并不是 bug。请改在提供商中进行变更。