---
title: PingFederate 身份验证 (OIDC)
slug: neurons/help/zh_cn/pingfederate-oidc
createdAt: 2026-09-07T07:01:36.589Z
---

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

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

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

1. 在 Ivanti Neurons 平台中，导航至**管理员** > **身份验证**。
   **身份验证**页面随即显示。
2. 在**外部身份验证 (SSO)** 部分中，点击**配置和启用**。
   **启用外部身份验证 (SSO)** 页面随即显示。
3. 从**提供程序**下拉列表中，选择 **PingFederate**。
4. 从**登录方法**下拉列表中，选择 **OpenId Connect (OIDC)**。
   **PingFederate 配置设置**随即显示。
   建议在 **PingFederate 管理员**控制台中配置详细信息时，让此标签页保持打开状态，以供后续参考。
:::

:::ExpandableHeading
## 步骤 2 - PingFederate 应用程序设置（PingFederate 管理员控制台）

1. 登录 PingFederate 控制台。
2. 从**应用程序**中，选择 **OAuth**。
3. 点击**添加客户端**。
4. 在**客户端**中，更新客户端配置和策略信息，具体如下：
   1. **客户端 ID**：输入所选的唯一客户端 ID。 复制此客户端 ID 并将其粘贴到已打开的 Ivanti Neurons 标签页的客户端 ID 字段中。
   2. **名称**：与**客户端 ID** 相同。
   3. **客户端身份验证**：选择**客户端密码**。
   4. **客户端密码**：选择**更改密码**，然点击**生成密码**。
   5. 复制**客户端密码**值并将其粘贴到已打开的 Ivanti Neurons 标签页的**客户端密码值**字段中。
   6. **重定向 URI**：从 Neurons 平台复制**重定向 URI** 并将其粘贴到 PingFederate 管理员门户中的**重定向 URI** 字段。
   7. 点击**添加**。
   8. **允许的授予类型**：选择**授权代码** 和**隐式**。
   9. **默认访问令牌管理器**：选择 **IvantiTestToken**。
   10. **OPENID CONNECT：**&#x4ECE; Neurons 平台复制**注销 URI** 并将其粘贴到 PingFederate 凭据门户上的**注销后重定向 URI** 字段中，然后点击**添加**。
   11. 单击**保存**。
5. 在**系统**中，选择**服务器&#x20;**>**&#x20;协议设置&#x20;**>**&#x20;联合信息**，复制**基本 URL** 并将其粘贴到已打开的 Ivanti Neurons 标签页的**发行者**字段中。
6. 在 Ivanti Neurons 标签页上点击**继续**以验证设置。
:::

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

必须使用 PingFederate 凭据进行连接，以验证连接设置。

1. 在**验证连接设置**页面上，点击**验证设置**。 组织的登录页面上随即打开一个新选项卡。 输入 PingFederate 凭据并点击**登录**。
2. 在**请求审批**页面上，确保已选择以下内容：
   - **访问用户名**
   - **OPENID 范围**
   - **配置文件范围**
   - **电子邮件范围**
3. 点击**允许**。
4. 返回**验证连接设置**页面，然后选中复选框以确认登录成功。
   PingFederate 凭据现已配置但未启用。 要启用，需要转换 Ivanti Neurons 平台账户，改为使用 PingFederate。
5. 点击**继续**以继续在转换 Ivanti Neurons 平台账户页面上执行后续操作。
:::

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

- **E2018 身份验证失败**：用户使用 PingFederate 进行身份验证失败。 检查用户名和密码准确无误，同时用户具有 PingFederate SP 连接权限。
- **E2019 缺失可选声明**：由于 PingFederate 返回给 Ivanti Neurons 平台的令牌中不存在附加可选声明，验证步骤失败。
- **E2020 无法链接到 Neurons 平台用户账户**：PingFederate 用户登录与 Ivanti Neurons 平台用户不匹配。 Ivanti Neurons 平台用户账户电子邮件地址必须匹配登录 PingFederate 时所使用的电子邮件地址。
:::

:::ExpandableHeading
## 步骤 4 - 启用 Ivanti Neurons 平台账户（Ivanti Neurons 平台）

1. 在**转换 Ivanti Neurons 平台账户**页面上，点击**注销和启用**。 Ivanti Neurons 是否已注销。
2. 点击**使用 PingFederate 登录**，然后输入 **PingFederate 凭据**完成流程。
3. 用户现在可以在**管理员** > **身份验证**中查看状态为**已启用**的 PingFederate 应用程序。    
4. 在 Neurons 平台上点击**注销** 。
   现在，用户重新登录时，系统会将用户路由到 PingFederate 选择帐户并使用 **PingFederate&#x20;**&#x51ED;据登录。
:::

:::hint{type="info"}
确保**应用程序** > **OAuth** > **访问令牌映射** > **IdP 适配器：PingOneIdpAdapter** > **访问令牌映射**中的**合同履行**字段包含 **email**、**given\_name** 和 **family\_name** 用户属性。
:::

## 配置自动配置

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

:::ExpandableHeading
## 启用自动配置

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

:::hint{type="info"}
启用后，用户可以编辑默认访问控制角色和禁用自动配置。 这些更改将仅应用于修改后配置的成员，不会影响现有成员。
:::

:::hint{type="danger"}
启用自动配置会授予所有 PingFederate 应用程序注册用户访问 Ivanti Neurons 的权限。 用户可以在 PingFederate 应用程序中操作，将访问权限限制为特定用户或组。
:::

## （可选）更新客户端密码（Ivanti Neurons 平台）

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

1. 在 Ivanti Neurons 平台中，导航至**管理员** > **身份验证**。
   **身份验证**页面随即显示。
2. 在“外部身份验证”部分，点击**操作** > **更新客户端密码**。
   该 **更新客户端密码**页面随即显示。
3. 输入从 PingFederate 应用程序获取的新客户端密码，**然后粘贴到 Ivanti Neurons 平台**的客户端密码值字段中。
4. 点击**继续**以验证客户端密码。
5. 在**验证新客户端密码**页面上，点击**验证客户端密码**。组织的登录页面上随即打开一个新选项卡。
6. 输入 PingFederate 凭据并点击**登录**。
7. 在**请求审批**页面上，确保已选择以下内容：
   1. **访问用户名**
   2. **OPENID 范围**
   3. **配置文件范围**
   4. **电子邮件范围**
8. 点击**允许**。
   如果成功，请返回到此向导，并继续更新客户端密码。
   如果失败，请检查输入的新客户端密码是否正确。 有关其他失败原因，请参阅[验证故障排除](docId\:GGaEr_ZkV2yNjxP5-UTGK)。
9. 返回**验证新客户端密码**页面，然后选中该复选框以确认登录成功。
10. 点击**继续**以继续在**保存新客户端密码**页面上执行后续操作。
11. 点击**保存更改**以完成流程。
    随即收到确认已成功更新客户端密码的通知。

## （可选）删除身份验证方法（Ivanti Neurons 平台）

1. 在 Ivanti Neurons 平台中，导航至**管理员** > **身份验证**。
   **身份验证**页面随即显示。
2. 在**外部身份验证**部分中，点击**操作** > **删除身份验证方法**。
   **删除外部身份验证**屏幕随即显示。
3. 点击**注销和重新进行身份验证**。
   Ivanti Neurons 是否已注销。
4. 点击**使用电子邮件和密码登录**。
5. 输入凭据并点击**登录**。
6. 导航至**管理员** > **身份验证** > **外部身份验证**，然后点击**操作** > **删除身份验证方法**。
   **删除外部身份验证**屏幕随即显示。
7. 点击**删除身份验证方法**。
   现有身份验证方法现已删除。
