SCIM 人员查看器会显示通过身份提供商 (IdP) 预配的用户和群组。你可以使用它检查 Cloudflare 收到的资源、查看其属性并调查预配问题。
每个视图对应一个身份提供商。其中的资源计数描述该提供商的 SCIM 人员数据，而非账户中的活跃用户或已占用席位数。要查看用户活动和身份历史记录，请参阅用户注册表。
- 为你的身份提供商配置 SCIM 预配。
- 使用具有读取身份提供商 SCIM 人员数据权限的账户角色。删除资源需要拥有编辑身份提供商的权限。
- 在 Cloudflare 仪表板 ↗中，前往 Zero Trust > Integrations > Identity providers。
- 找到已启用 SCIM 的身份提供商。
- 在 SCIM resources 中，选择用户或群组计数。
- 选择 Users（用户） 或 Groups（群组） 切换资源类型。
如果相应属性可用，Users（用户） 表格会显示每个用户的姓名、用户名、电子邮件地址和活跃状态。活跃状态反映 SCIM active 属性，不表示用户最近是否有活动，也不表示最新预配请求是否成功。
Groups（群组） 表格会显示群组名称和 IdP 资源 ID。
- 选择 Users（用户） 或 Groups（群组）。
- 选择搜索字段并输入搜索值。
- 选择 Search。要清除搜索条件，请选择 Clear。
| 资源类型 | 搜索字段 |
|---|---|
| 用户 | 用户名包含、用户名、电子邮件、姓名、Cloudflare 资源 ID、IdP 资源 ID |
| 群组 | 名称包含、名称、Cloudflare 资源 ID、IdP 资源 ID |
使用 Cloudflare resource ID 匹配SCIM 预配日志中的资源条目。使用 IdP resource ID 将资源与身份提供商中的对应记录进行匹配。
对于用户或群组，选择 View details。在 Formatted 和 JSON 视图之间切换，以检查存储的资源。
详情在相应信息存在时会包含资源 ID、个人资料属性、成员关系和元数据。SCIM id 是 Cloudflare 资源 ID。externalId 是 IdP 资源 ID。元数据时间戳表示资源的创建或修改时间，不会报告最新预配请求是否成功。
对于包含成员的群组，选择 View all group members 查看其成员列表。
删除资源会将其从 Cloudflare 中该身份提供商的 SCIM 人员数据中移除，但不会删除 IdP 中的上游用户或群组。请在身份提供商中进行永久性预配更改。
- 找到要移除的用户或群组。
- 打开其上下文菜单并选择 Delete。
- 在确认对话框中检查资源名称，然后选择 Delete。
使用 Cloudflare API 获取身份提供商的资源。为目标账户创建 API token，并授予 Access: Organizations, Identity Providers, and Groups Read 权限。请使用此 Cloudflare API token，而不是 IdP 中配置的 SCIM bearer token。
列出用户：
curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/access/identity_providers/%7Bidentity_provider_id%7D/scim/users?page=1&per_page=25" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"列出群组：
curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/access/identity_providers/%7Bidentity_provider_id%7D/scim/groups?page=1&per_page=25" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"响应包含 result 数组和 result_info 分页元数据。增加 page 值以获取后续页面。两个端点每页最多支持 100 个资源。
有关筛选器、单个资源查询和删除端点，请参阅 SCIM API 参考。
- 资源计数与 IdP 不一致： 检查 IdP 分配给 SCIM 应用的用户和群组。查看器显示的是预配到此集成的资源，而非整个 IdP 目录。
- 能看到用户，但看不到群组： 检查 IdP 的群组预配设置。Okta 需要 Push Groups。Microsoft Entra ID 会在配置的预配范围内预配群组。
- 计数显示 Users unavailable 或 Groups unavailable： Cloudflare 无法获取该资源计数。这不表示资源数为零。请打开查看器并检查是否有错误。
- 资源缺失或属性异常： 将 SCIM 预配日志与 IdP 的预配日志进行比较。按资源 ID 匹配记录，以调查失败的请求或属性差异。