SCIM 预配
使用 SCIM 从你的身份提供商为控制台成员进行预配和取消预配。
SCIM 功能适用于企业套餐。
SCIM（System for Cross-domain Identity Management，跨域身份管理系统）允许管理员直接从你的身份提供商为 Mintlify 组织的成员进行预配和取消预配。
SCIM 管理谁可以访问你的组织。要控制用户如何登录，请设置 SSO。
Mintlify 的 SCIM 端点可与任何符合 SCIM 2.0 标准、并使用 bearer token 进行身份验证的身份提供商配合使用。下面的分步说明以 Okta 为例。对于其他提供商，请联系我们以获取设置指导。
打开 SCIM 设置
在 Mintlify 控制台中，前往 “Identity & access” 页面的 SCIM 标签页。
开启 SCIM
点击 Configure SCIM。Mintlify 会生成一个 SCIM base URL 和一个 bearer token。
请妥善保存该 bearer token。Mintlify 只会显示一次，之后无法再次查看。
将凭据添加到你的身份提供商
将 SCIM base URL 和 bearer token 输入到你身份提供商的 SCIM 应用配置中。参见配置你的身份提供商以获取针对不同提供商的操作步骤。
在 Okta 中添加 SCIM 应用
在 Okta 中，进入 Applications，点击 Browse App Catalog 并搜索 SCIM 2.0 Test App (Header Auth)。这是 Okta 针对任何使用 bearer token 进行身份验证的 SCIM 2.0 API 的标准集成。
添加你的 Mintlify 凭据
在该应用的 Provisioning 设置中，输入 Mintlify 的 SCIM base URL 和 bearer token。token 的格式为 Bearer <token>。
启用预配操作
在 Provisioning to app 下，启用你希望 Okta 管理的创建、更新和停用选项。请关闭 Sync password，因为 Mintlify 不使用由 Okta 管理的密码。
创建并推送组
在 Okta 中，为每一组你希望进行预配的用户使用现有的组或新建组，然后在 Push groups 下将这些组推送到 SCIM 应用。
组名称区分大小写。你在 Mintlify 中映射的名称必须与 Okta 组名称完全一致。
分配用户
在 Assignments 下，将相关的组或单个用户分配给该应用。
将组映射到角色
在 Mintlify 控制台中，将每个已推送的组名称映射到控制台角色。参见将组映射到角色。
根据用户在身份提供商中的组成员身份为其分配角色。
- 在 Mintlify 控制台中，前往 “Identity & access” 页面的 SCIM 标签页。
- 在 “Group-to-role mappings” 部分，点击 Add mapping。
- 输入身份提供商中的组名称，并选择一个角色。
当用户同时属于多个已映射的组时，Mintlify 会为其分配这些组中权限最高的角色。
你可以随时编辑或删除映射。此映射是单向的，只会控制某个组在 Mintlify 中获得的角色。例如，如果你将身份提供商中的 developers 组映射为编辑者（editor）角色，之后又将该映射更改为查看者（viewer），那么 developers 组的新成员将成为 Mintlify 中的查看者，但 developers 组本身在你的身份提供商中不会发生变化。
如果 bearer token 泄露，或作为常规凭据维护的一部分，请轮换该 token。
- 前往 “Identity & access” 页面的 SCIM 标签页。
- 点击 Rotate token。
- 复制新 token 并更新你身份提供商的 SCIM 配置。
轮换 token 会立即使之前的 token 失效。在你使用新 token 更新身份提供商之前，预配将无法正常工作。
- 前往 “Identity & access” 页面的 SCIM 标签页。
- 关闭 SCIM 开关。
停用 SCIM 会阻止来自你身份提供商的新预配和取消预配事件。现有的控制台成员仍将保留其当前访问权限，直至通过手动或其他方式将其移除。