---
title: Entra ID 身份验证 (OIDC)
slug: neurons/help/zh_cn/entra-id-oidc
createdAt: 2026-09-07T07:01:36.399Z
---

用户目前可通过 Ivanti Neurons 选择将 Entra ID 作为租户的外部身份验证提供程序。 如果您希望提供集中化的最终用户登录体验，减少因密码相关问题而呼叫帮助中心的次数，并对策略和审计跟踪进行精细控制，那么这是一个很好的选择。

:::hint{type="info"}
要使用 Entra ID，所有成员必须接受 Ivanti 访问其基本 Azure 配置文件数据的请求。
:::

## 配置并启用外部身份验证

::::ExpandableHeading
## 步骤 1 - 配置并启用外部身份验证（Ivanti Neurons 平台）

1. 在 Ivanti Neurons 平台中，导航至**管理员** > **身份验证**。
   随即显示**身份验证**页面。
2. 在**外部身份验证 (SSO)** 部分中，点击**配置和启用**。
   随即显示**启用外部身份验证 (SSO)** 页面。
3. 从**提供程序**下拉列表中，选择 **Entra ID**。
   随即显示 **Entra ID 配置设置**。

:::hint{type="info"}
必须首先在 Microsoft Azure 门户执行一些步骤，才能继续 Ivanti Neurons 配置。
:::
::::

::::ExpandableHeading
## 步骤 2 - Entra ID 设置（Microsoft Azure 门户）

必须首先在 Microsoft Azure 门户执行以下步骤，才能继续 Ivanti Neurons 配置。

### 步骤 A - 创建 Entra ID 应用程序

1. 以 Office 365 管理员身份登录 **Entra ID 管理员中心**。
2. 在侧栏菜单中，点击 **Entra ID > 应用程序注册**。
   随即显示**应用程序注册仪表板**。
3. 点击**新注册**。
4. 为应用程序输入一个合适的名称，并接受默认支持的帐户类型：**仅此组织目录中的帐户**。

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/4M8Wj7Ij31d3Xxd2y5_QY_azureadappregsettings.png" alt="Microsoft Azure“注册应用程序”屏幕" position="flex-start" size="80" width="894" height="778" initialPath="Images/AzureADAppRegSettings.png" githubPath="CHS/Images/AzureADAppRegSettings.png" showCaption="false"}

5. 在**重定向 URI** 部分下，从**选择平台**下拉列表中选择**Web**。 输入 Neurons 平台 Entra ID 配置设置中显示的**重定向 Uri**。
6. 单击对话框底部的**注册**。
7. 应用程序注册完成后，将显示成功消息并重定向到已注册应用程序的概述页面。

:::hint{type="danger"}
需要记录此**应用程序（客户端）ID** 和**目录（租户）ID**，因为 Ivanti Neurons 的下个设置阶段会需要此信息。
:::

### 步骤 B - 配置身份验证设置

1. 在已创建的应用程序上，转至 **管理** > **身份验证（预览）**。
2. 导航至**设置**。
3. 在**隐式授权和混合流**部分，确保选中 **ID 令牌**复选框。

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/N6JAx4HckY-3ni1XnjRRt_azureadidtoken.png" alt="隐式授权和混合流屏幕显示所选 ID 令牌" position="flex-start" size="73" width="734" height="195" initialPath="Images/AzureADidToken.png" githubPath="CHS/Images/AzureADidToken.png" showCaption="false"}

4. 在**前端通道注销 URL** 字段中输入**注销 URL**，如 Neurons 平台 Entra ID 配置设置中所示。
5. 单击**保存**。

### 步骤 C - 创建密码

1. 在已创建的应用程序上，转至**管理** > 证书密钥。
2. 在**客户端密钥**选项卡下，点击**新客户端密码**。
3. 添加说明。
4. 根据公司标准选择过期时间。
5. 点击**添加**。
6. 创建值后，必须将其复制到安全的地方，因为只有在此处可以查看密钥。

:::hint{type="success"}
确保复制的是**密码值**而不是**密码 ID**。
:::

Entra ID 设置现已完成，可返回 Ivanti Neurons 平台。

:::hint{type="danger"}
密钥使用时间是有限的，因此您的公司应采取适当措施，确保在过期前进行更换，以避免任何 Ivanti Neurons 平台中断。 了解如何[更新客户端密码](https://docs.ivanti.com/neurons/help/zh_cn/entra-id-oidc#Clientsecret)。
:::

### 步骤 D - 令牌配置

请设置令牌配置以便使用自动配置。

1. 在已创建的应用程序上，转至**管理** > **令牌配置**。
2. 选择**添加可选声明**以打开侧面板。
3. 对于**令牌类型**，选择 **ID**。
4. 从**声明**列表中，选择 **email**、**family\_name** 和 **given\_name**。 这样便可获取 Ivanti Neurons 平台新成员的电子邮件、姓氏和名字，使用自动配置时要求进行此操作。
5. 点击**添加**。
   出现 Microsoft Graph 权限弹出窗口。
6. 在 Microsoft Graph 权限弹出窗口中，选中复选框并点击**添加**。

### 步骤 E - 授予权限

如果设置 SSO 的用户不是 Azure 管理员，则需要 Azure 管理员登录 Azure 并批准用户读取/登录应用程序的权限请求。

1. 选择 EntraID 应用程序的**管理** > **API 权限**。 必须以 Azure 管理员身份登录。
2. 如果在安全密码器配置期间选中了复选框，则包括 User.Read 在内的少数权限将作为授权权限添加到 Microsoft Graph。
3. 如果委派权限列表中没有 User.Read 权限，则需要进行添加。 若要执行此操作：
   - 选择**添加权限**。
   - 选择 **Microsoft Graph > 委派权限**。
   - 选择 **User.Read** 权限。
4. 选择**为 \<entraid\_tenant> 授予管理员同意**。
::::

:::ExpandableHeading
## 步骤 3 - Entra ID 配置设置（Ivanti Neurons 平台）

创建 Entra ID 应用程序（客户端）、目录（租户）和密钥后，您可以继续进行 Ivanti Neurons 平台配置。

1. 返回 **Entra ID 配置设置**页面（**Ivanti Neurons 平台** > **身份验证&#x20;**> **外部身份验证 (SSO)** > **配置并启用**）。
2. 输入 Entra ID 应用程序注册时的**目录（租户）ID**。
3. 输入 Entra ID 应用程序注册时的**应用程序（客户端）ID**。
4. 输入生成并保存的**客户端密码值**。
5. 输入**客户端密码过期日期**，此日期应该与在创建客户端密码时指定的过期日期相匹配。 有关更多详细信息，请参阅“更新客户端密码”。
6. 点击**继续**即会显示“验证连接设置”页面。
:::

::::ExpandableHeading
## 步骤 4 - 验证连接设置（Ivanti Neurons 平台）

您需要连接 Entra ID 凭据来验证连接设置。

1. 在“验证连接设置”页面，点击**验证设置**，通过新选项卡访问贵组织的登录页面，输入 Entra ID 凭据并继续登录。 如果您已经登录，则不需要输入凭据，而验证会自动进行，因此，请确保您已登录您要进行身份验证的帐户。
   如果登录成功，您将会收到确认屏幕。

:::hint{type="info"}
Azure 用户名必须准确匹配您的 Ivanti Neurons 用户名。
:::

返回到此选项卡（验证连接设置）。

3. 选中**我确认已成功验证连接设置**复选框，确认已成功登录。
4. 点击**继续**以继续转换 Ivanti Neurons 平台帐户。
   随即显示**启用 Ivanti Neurons 平台账户**页面。

:::ExpandableHeading{customAnchorSlug="Validationtroubleshooting"}
## 验证故障排除

- **E2018 身份验证失败**：用户使用 Entra ID 进行身份验证失败。 检查用户名和密码是否正确，以及用户是否具有 Entra ID 应用程序注册权限。
- **E2019 缺失可选声明**：由于 Entra ID 返回给 Ivanti Neurons 平台的令牌中不存在附加可选声明，验证步骤失败。
- **E2020 无法链接到 Neurons 平台用户帐户**：Entra ID 用户登录与 Ivanti Neurons 平台用户不匹配。 Ivanti Neurons 平台用户帐户电子邮件地址*必须*匹配登录 Entra ID 时所使用的电子邮件地址。
:::
::::

::::ExpandableHeading
## 步骤 5 - 启用 Ivanti Neurons 平台帐户（Ivanti Neurons 平台）

Entra ID 现已配置但未启用。

要进行启用，需要转换 Ivanti Neurons 平台帐户，改为使用 Entra ID。

1. 在**启用 Ivanti Neurons 平台账户**页面，点击**注销和启用**。
   随即显示 **Ivanti Neurons 登录**页面。
2. 选择**使用 Entra ID 登录**并输入 Entra ID 凭据，然后便可完成转换。

:::hint{type="info"}
同一用户必须在 Ivanti Neurons 中配置 Entra ID 身份验证，然后登录并验证凭据，以避免“访问拒绝”错误。
:::

所有成员将收到确认帐户已转换以及必须使用 Entra ID 凭据继续访问租户的电子邮件。 如果成员不具备 Entra ID 凭据，则将无法访问 Ivanti Neurons。

:::hint{type="info"}
外部身份验证 (SSO) 现在将显示为**已启用**状态。
:::
::::

## 配置自动配置

启用自动配置将自动向 Entra ID 应用程序注册中的所有成员授予对 Ivanti Neurons 的访问权限，而无需进行手动邀请过程。 新成员首次登录时，将会在 **Ivanti Neurons** > **成员**中配置新 Ivanti Neurons 平台帐户。 自动配置的所有新成员将会被授予设置中所定义的访问控制角色。

:::hint{type="info"}
在启用自动配置之后，有权访问 **Entra ID 应用程序注册**的任何人都将有权访问 **Ivanti Neurons**。 用户可以在 **Entra ID 门户**中操作，将访问权限限制为特定用户或组。 有关详细信息，请参阅 [Microsoft Azure 说明文档](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/assign-user-or-group-access-portal)。
:::

:::ExpandableHeading{customAnchorSlug="Enable"}
## 启用自动配置

1. 在 Ivanti Neurons 平台中，导航至**设置** > **身份验证**。
   随即显示**身份验证方法**页面。
2. 在**外部身份验证 (SSO)** 部分中，点击**操作**并选择**启用自动配置**。
3. 从**默认角色**下拉列表中，选择要分配给所有新成员的访问控制角色。
   要设置**角色**，请转至 **Ivanti Neurons** > **管理员** > **角色**。
4. 点击**启用自动配置**以确认角色选择，并为所有新成员启用自动配置。
:::

启用后，以下选项将变为可用：**编辑**默认访问控制角色和**禁用**自动配置。 任何角色编辑或自动配置禁用将不会影响任何现有自动配置成员，而是仅适用于作出更改后配置的成员。

:::hint{type="info"}
您必须通过[步骤 D - 令牌配置](https://docs.ivanti.com/neurons/help/zh_cn/entra-id-oidc#Step4)配置可选声明，以使自动配置生效。
:::

:::hint{type="info"}
**重要事项**：在启用自动配置之后，有权访问 Entra ID 应用程序注册的任何人都将有权访问 Ivanti Neurons。 您可以从 Entra ID 门户中将访问权限限制为特定用户或组。 有关更多详细信息，请参阅 [Microsoft Azure 文档](https://docs.microsoft.com/en-us/azure/active-directory/manage-apps/assign-user-or-group-access-portal)。
:::

## 更新客户端密码

如果 Entra ID 客户端密码即将过期，那么您需要设置新密码，才能继续使用此身份验证方法。

1. 在 Ivanti Neurons 平台中，导航至**设置** > **身份验证**。
2. 点击**操作**，然后选择**更新客户端密码**。
   随即显示**更新客户端密码**页面。
3. 从 Entra ID 应用程序输入新**客户端密码**。
4. 输入日期，以便在客户端密码即将过期时接收提醒。 在到期日期之前 28 天，将在 UI 中显示提醒横幅，并向具有管理员角色的用户发送电子邮件提醒。 在到期日期之前 7 天和 1 天，将再次发送电子邮件提醒。
   如果客户端密码过期，并且未设置新密码，则对服务的访问权限将被终止，需要联系 Ivanti 支持部门重新获取访问权限。
5. 点击**继续**。
   随即显示**验证客户端密码**页面。
6. 点击**验证客户端密码**，此操作将打开 Entra ID 登录页面。
   输入用户名和密码，此凭据将与 Ivanti Neurons 平台的登录凭据相同。 登录时，系统会验证新客户端密码。 如果成功，请返回到此向导，并继续更新客户端密码。 如果不成功，请回来检查您输入的新客户端密码是否准确。 有关其他失败原因，请参阅[验证故障排除](https://docs.ivanti.com/neurons/help/zh_cn/entra-id-oidc#Validationtroubleshooting)。
7. 在成功验证新客户端密码之后，请选中**我确认已成功验证新客户端密码**确认复选框，然后点击**继续**。
8. 点击**保存更改**，以完成流程。 此操作会更新客户端密码和过期提醒，立即生效，您无需进行任何其他操作。
