# 使用 Microsoft Entra ID 进行 SCIM 预配

[Microsoft Entra ID](https://www.microsoft.com/en-us/security/business/microsoft-entra) 可以使用 SCIM（跨域身份管理系统）将用户预配到 API7 网关。

本指南介绍如何在 Microsoft Entra ID 与 API7 控制台之间配置 SCIM 预配。

## 前置条件[​](#前置条件 "前置条件的直接链接")

开始前，请确保：

* 已安装 API7 网关且可以访问控制台。
* 你拥有具备管理权限的 Microsoft Entra ID 租户。
* 你在 API7 网关中拥有可管理组织设置的用户账户。

## 第 1 步：创建非库企业应用[​](#第-1-步创建非库企业应用 "第 1 步：创建非库企业应用的直接链接")

1. 登录 Microsoft Entra 管理中心。
2. 转到 **Enterprise applications** -> **New application**。
3. 点击 **Create your own application**。
4. 输入应用名称。
5. 选择 **Integrate any other application you don't find in the gallery (Non-gallery)**。
6. 点击 **Create**。

## 第 2 步：在 API7 网关中启用 SCIM[​](#第-2-步在-api7-网关中启用-scim "第 2 步：在 API7 网关中启用 SCIM的直接链接")

1. 使用管理员账户登录 API7 控制台。
2. 转到 **组织 > 设置**。
3. 启用 **SCIM Provisioning**。
4. 复制 **API7 SCIM 端点 URL** 和 **SCIM 令牌**。

## 第 3 步：在 Microsoft Entra ID 中配置预配[​](#第-3-步在-microsoft-entra-id-中配置预配 "第 3 步：在 Microsoft Entra ID 中配置预配的直接链接")

1. 打开刚创建的企业应用。
2. 转到 **Provisioning**。
3. 将 **Provisioning Mode** 更改为 **Automatic**。
4. 在 **Authentication Method** 中保留 **Bearer Authentication**。
5. 将 **Tenant URL** 设置为从 API7 网关复制的 SCIM 端点。
6. 将 **Secret Token** 设置为从 API7 网关复制的 SCIM Token。
7. 点击 **Test Connection**。
8. 确认显示成功消息：**The supplied credentials are authorized to enable provisioning**。
9. 点击 **Save**。

![Microsoft Entra 预配页面](https://static.api7.ai/uploads/2026/05/07/Ze9AtaF7_pw-entra-provisioning.png)

## 第 4 步：更新预配设置[​](#第-4-步更新预配设置 "第 4 步：更新预配设置的直接链接")

1. 在同一 **Provisioning** 页面中展开 **Settings**。
2. 将 **Scope** 设置为 **Sync all users and groups**。
3. 点击 **Save**。

使用 **Sync all users and groups** 可以避免 Entra 权限检查，否则该检查可能导致按需预配无法进入 SCIM 创建步骤。

## 第 5 步：查看默认映射[​](#第-5-步查看默认映射 "第 5 步：查看默认映射的直接链接")

API7 网关支持预配 SCIM User 资源。启用预配前，请配置映射：

1. 在 **Mappings** 下，保持启用 **Provision Microsoft Entra ID Users**。
2. 打开 **Provision Microsoft Entra ID Groups**，将 **Enabled** 设置为 **No** 并保存映射。API7 网关不提供 SCIM Group 资源。

## 第 6 步：分配用户或组[​](#第-6-步分配用户或组 "第 6 步：分配用户或组的直接链接")

1. 在企业应用中转到 **Users and groups**。
2. 点击 **Add user/group**。
3. 选择用户，或包含这些用户的源组。
4. 点击 **Assign**。
5. 返回 **Provisioning**，将 **Provisioning Status** 设置为 **On** 并保存。

分配源组不会在 API7 网关中预配 SCIM Group 资源。

![Microsoft Entra 用户和组](https://static.api7.ai/uploads/2026/05/07/QDh2S76P_pw-entra-users-groups-crop-6754885fd6df74af158c47efa8037324.png)

## 第 7 步：验证预配行为[​](#第-7-步验证预配行为 "第 7 步：验证预配行为的直接链接")

1. 返回 **Provisioning**。

2. 打开 **Provision on demand**。

3. 搜索已分配的用户并执行一次按需预配。

4. 确认以下步骤均成功：

   * **Import user**
   * **Determine if user is in scope**
   * **Match user between source and target system**
   * **Perform action**

在经过验证的流程中，Microsoft Entra ID 成功在目标应用中创建用户。结果窗格会显示：

* **Perform action**：`Success`
* **Result**：`User '<userPrincipalName>' was created in customappsso`

## 第 8 步：在 API7 网关中验证预配用户[​](#第-8-步在-api7-网关中验证预配用户 "第 8 步：在 API7 网关中验证预配用户的直接链接")

1. 返回 API7 控制台。
2. 转到 **组织 > 用户**。
3. 确认从 Microsoft Entra ID 预配的用户出现在用户列表中。

![在控制台中验证用户](https://static.api7.ai/uploads/2026/01/21/yHR5bX0B_okta-scim-17-dashboard-check-users.png)

SCIM 负责预配用户账户，但角色分配仍由 API7 网关 RBAC 管理。如果还配置了控制台 SSO 角色映射，用户登录时可以根据 SSO 映射规则刷新角色。

如果还配置了控制台 SSO，可以通过 Microsoft Entra ID 管理预配用户，并通过选定的登录方式完成身份认证。

## 后续步骤[​](#后续步骤 "后续步骤的直接链接")

* [为控制台配置 SCIM 预配](https://docs.apiseven.com/api7-gateway/security-and-compliance/authenticate/scim.md)
* [控制台单点登录（SSO）](https://docs.apiseven.com/api7-gateway/security-and-compliance/sso-dashboard.md)
* [基于角色的访问控制（RBAC）](https://docs.apiseven.com/api7-gateway/security-and-compliance/role-based-access-control.md)
