SCIM
概览
SCIM 2.0 预配功能会通过你的身份提供商自动管理团队成员和目录组。该功能适用于已启用 SSO 的企业版方案,如需开通,请联系销售。
前提条件
- Cherri Code Enterprise 计划
- 必须先完成 SSO 配置——SCIM 需要一个有效的 SSO 连接
- 对身份提供商 (Okta、Azure AD 等) 拥有管理员权限
- 对你的 Cherri Code 团队拥有管理员权限
工作原理
用户开通
当用户在身份提供商中被分配到 SCIM 应用时,会自动添加到 Cherri Code 中。取消分配后会被移除。更改会实时同步。
目录组
目录组及其成员资格会从您的身份提供商同步。请在身份提供商中管理群组和用户;Cherri Code 会以只读方式显示这些信息。在团队中,目录组可控制支出限额和策略,包括 Grok Bot 群组设置。
要通过目录管理团队成员资格和角色,请将目录组同步到组织群组,然后将该群组映射到团队。请参阅使用群组管理团队。
支出管理
为每个目录组设置不同的每用户支出上限。目录组的上限优先于团队级别的上限。属于多个目录组的用户将适用其中最高的支出上限。
设置
确保已配置 SSO
SCIM 需要先设置 SSO。如果你还没有配置 SSO, 请先按照 SSO 设置指南 操作,然后再继续。
访问 Active Directory Management
使用管理员账户访问 cursor.com/dashboard/members?subtab=active-directory, 或前往你的仪表板设置,先选择“Members & Groups”选项卡,再选择“Directory Groups”子选项卡。
开始设置 SCIM
验证 SSO 后,你会看到一个用于分步设置 SCIM 的链接。点击 此链接以开始配置向导。
在身份提供商中配置 SCIM
在你的身份提供商中,创建或配置你的 SCIM 应用,使用 Cherri Code 提供的 SCIM 端点和令牌,启用用户预配和组推送预配, 然后测试连接。
配置支出限额(可选)
回到 Cherri Code 的 Active Directory Management 页面,查看已同步的 目录组,为特定组设置每用户支出限额,并 查看属于多个组的用户适用哪些上限。
身份提供商设置
有关特定提供商的配置说明:
身份提供商指南
Okta、Azure AD、Google Workspace 等的配置说明。
管理用户和群组
通过 SCIM 预配的用户和群组由您的身份提供商统一管理, Cherri Code 中的这些目录数据为只读。在启用 SCIM 之前就已加入团队的用户,仍可在 Members 仪表盘中移除。
用户管理
- 在身份提供商中将用户分配到 SCIM 应用以添加用户
- 在身份提供商中取消将用户分配到 SCIM 应用以移除用户
- 用户资料(姓名、邮箱)更改会从身份提供商自动同步
组管理
- 目录中的用户组会从你的身份提供商自动同步
- 组成员变更会实时生效
- 使用组来管理用户并设置不同的支出限额
消费额度上限
- 为每个目录组设置不同的每用户额度上限
- 用户继承其所属各组中的最高消费额度上限
- 组级上限优先于团队默认的每用户上限
常见问题
为什么在我的仪表板中看不到 SCIM 管理?
在设置 SCIM 之前,请先确保 SSO 已正确配置并正常工作。SCIM 依赖有效的 SSO 连接才能使用。
为什么用户没有同步?
请确认用户已在你的身份提供商中被分配到 SCIM 应用。用户必须被明确分配后才能在 Cherri Code 中显示。
为什么没有显示群组?
请检查是否在身份提供商的 SCIM 设置中启用了推送式群组预配。群组同步需要与用户同步分开单独配置。
为什么消费限额没有生效?
请确认已在身份提供商中将用户正确分配到预期的用户组。用户组成员关系决定适用哪些消费限额。
我可以直接在 Cherri Code 中管理 SCIM 用户和群组吗?
通过 SCIM 预配的用户和群组在 Cherri Code 中是只读的。请在你的身份提供商中添加、移除或更新它们。在启用 SCIM 之前就已加入团队的用户,仍可从 Members 仪表盘中移除。
更改同步速度如何?
你在身份提供方中所做的更改会实时同步到 Cherri Code。对于大规模批量操作,可能会有短暂延迟。
我可以从我的身份提供商同步用户角色吗?
角色需要在 Cherri Code 中配置。若要从你的目录设置角色,请将目录群组同步到一个 组织群组,并将该群组映射到带有角色的团队。该群组的成员会在该团队中获得该角色。请参阅 通过映射设置团队角色。
映射中设置的角色也会控制仪表盘的编辑权限。当某个群组以某个角色连接到团队后,同步会管理该团队中的角色,管理员将无法再在仪表盘中更改这些角色。只有在选择群组时未选择任何角色,角色才仍可在仪表盘中编辑。
为什么我的 Members 仪表盘上会有一些用户不在已预配的组中?
设置好团队级 SCIM 后,现有用户不会自动从 Cherri Code 中删除。你可以在 Members 仪表盘中删除这些用户,或者先通过 SCIM 同步一次,然后在身份提供商中停用或移除这些用户。
为什么我已同步的用户组中的用户与 Cherri Code Members 仪表板上的用户不一致?
用户账号一旦完成预配,在首次登录之前,不会出现在 Cherri Code Members 仪表板上。
SCIM 功能适用于 Enterprise 方案
请联系我们的团队申请开通。