概述¶
SCIM 2.0 预配可通过您的身份提供商自动管理团队成员和目录组。企业版方案启用 SSO 后即可使用；请联系销售以获取访问权限。
本页面介绍适用于单个团队的 SCIM。如果您在一个组织下运行多个关联团队，
还可以在组织级别同步目录组，并通过
组织群组在各团队中使用这些目录组。
前提条件¶
- Cursor 企业版方案
- 已配置 SSO。SCIM 需要有效的 SSO 连接
- 身份提供商 (Okta、Azure AD 等) 的管理员权限
- Cursor 团队的管理员权限
工作原理¶
用户预配¶
在身份提供商中被分配至 SCIM 应用的用户会自动添加到 Cursor。取消分配后，用户会被移除。更改会实时同步。
目录组¶
目录组及其成员资格会从您的身份提供商同步。请在身份提供商中管理群组和用户；Cursor 会以只读方式显示这些信息。在团队中，目录组可控制支出限额和策略。
要通过目录管理团队成员资格和角色，请将目录组同步到组织群组，然后将该群组映射到团队。请参阅使用群组管理团队。
支出管理¶
为每个目录组设置不同的用户支出限额。目录组限额优先于团队级限额。属于多个群组的用户将采用适用范围内最高的支出限额。
设置¶
确认已配置 SSO¶
使用 SCIM 前，需先设置 SSO。如果您尚未配置 SSO，
请先按照 SSO 设置指南完成设置，再继续操作。
访问 Active Directory Management¶
使用管理员账户访问
cursor.com/dashboard/members?subtab=active-directory，
或前往仪表盘设置，依次选择“成员和群组”标签页和“目录组”子标签页。
开始设置 SCIM¶
SSO 验证通过后，您会看到 SCIM 分步设置链接。点击该链接，
启动配置向导。
在身份提供商中配置 SCIM¶
在身份提供商中创建或配置 SCIM 应用，使用 Cursor 提供的 SCIM
端点和令牌，启用用户预配和推送群组预配，然后测试连接。
配置支出限额（可选）¶
返回 Cursor 的 Active Directory Management 页面，查看已同步的
目录组，为特定群组设置每位用户的支出限额，并
查看属于多个群组的用户适用哪些限额。
身份提供商设置¶
有关各身份提供商的设置说明：
身份提供商指南¶
Okta、Azure AD、Google Workspace 等身份提供商的设置说明。
管理用户和群组¶
所有用户和群组均须通过您的身份提供商进行管理。
在身份提供商中所做的更改会自动同步到 Cursor，但
您无法直接在 Cursor 中修改用户或群组。
用户管理¶
- 在身份提供商中为用户分配 SCIM 应用，即可添加用户
- 取消为用户分配 SCIM 应用，即可移除用户
- 用户资料更改 (姓名、电子邮件) 会自动从身份提供商同步
群组管理¶
- 目录组会自动从您的身份提供商同步
- 群组成员变更会实时同步
- 使用群组管理用户，并设置不同的支出限额
支出限额¶
- 为每个目录组设置不同的用户限额
- 用户将继承其所属群组中最高的支出限额
- 群组限额会覆盖默认的团队范围用户限额
常见问题¶
为什么我的仪表盘中未显示 SCIM 管理功能？¶
请先确保 SSO 已正确配置且正常运行，再设置 SCIM。SCIM 需要有效的 SSO 连接才能正常运行。
为什么用户没有同步？¶
请确认已在身份提供商中将用户分配到 SCIM 应用。只有明确分配的用户才会显示在 Cursor 中。
为什么看不到群组？¶
请检查是否已在身份提供商的 SCIM 设置中启用推送群组预配。群组同步需与用户同步分别配置。
为什么支出限额未生效？¶
请确认用户已在您的身份提供商中被正确分配到相应的群组。群组成员资格决定适用的支出限额。
我可以直接在 Cursor 中管理 SCIM 用户和群组吗？¶
不可以。所有用户和群组都必须通过您的身份提供商进行管理。Cursor 仅以只读方式显示这些信息。
更改多久会同步？¶
在身份提供商中所做的更改会实时同步到 Cursor。大规模批量操作可能会有短暂延迟。
我可以从身份提供商同步用户角色吗？¶
角色在 Cursor 中配置。要根据目录设置角色，请将目录组同步到组织群组，然后将该群组映射到团队并指定角色。群组成员将在该团队中获得该角色。请参阅通过映射设置团队角色。
映射中指定的角色也会影响是否可在仪表盘中编辑。群组以指定角色关联到团队后，同步将管理该团队的角色，管理员无法再在仪表盘中更改这些角色。只有在选择群组时未指定角色，角色才可在仪表盘中编辑。
为什么我的成员仪表盘中有些用户不属于已预配的群组？¶
设置团队级 SCIM 后，现有用户不会自动从 Cursor 中移除。您可以手动将其移除，或者先通过 SCIM 同步一次，再在身份提供商中取消预配，从而将其从 Cursor 中移除。
为什么已同步群组中的用户与 Cursor 成员仪表盘上显示的用户不一致？¶
用户账户创建后，首次登录前不会显示在 Cursor 成员仪表盘中。
SCIM 适用于企业版方案¶
请联系我们的团队申请访问权限。
