---
title: PingFederate 身份验证 (SAML)
slug: neurons/help/zh_cn/pingfederate-saml
createdAt: 2026-09-07T07:01:36.565Z
---

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

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

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

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

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

1. 登录 **PingFederate 管理员控制台**。
2. 在**应用程序**中，选择 **SP 连接**。
3. 点击**创建连接**。
4. 在**连接模板**中，选择**不要对此连接使用模板**，然后点击**下一步**。
5. 在**连接类型**中，选择**浏览器 SSO 配置文件**，因为此设置需要浏览器访问权限。
6. 在**协议**下拉列表中，选择 **SAML 2.0**，然后点击**下一步**。
7. 在**连接选项**中，选择**浏览器 SSO**，然后点击**下一步**。
8. 在**导入元数据**中，选择**无**，然后点击**下一步**。
9. 在**常规信息**中，输入已打开的 Ivanti Neurons 标签页中的以下详细信息：
   - **合作伙伴实体 ID（连接 ID）**：唯一的连接标识符（**实体 ID**）。
   - **连接名称**：此连接的语言标识符。
10. （可选）使用**基本 URL** 指定多个虚拟服务器 ID 以简化合作伙伴端点配置，然后点击**下一步**。
11. 在**浏览器 SSO**中，点击**配置浏览器 SSO** 以设置或编辑基于浏览器的合作伙伴资源安全 SSO 配置。
    1. 在 **SAML 配置文件**中，选择 **SP 发起的 SSO** 以指定身份提供程序和服务提供程序之间交换的消息类型以及传输方法（绑定），然后点击**下一步**。
    2. 在**断言生命周期**中，设置向 SP 发出断言之前和之后的有效时间范围，然后点击**下一步**。
    3. 在**断言创建**中，点击**配置断言创建**，以设置通过 SSO 访问 SP 合作伙伴站点的 SAML 断言。
       1. 在**身份映射**中，选择**标准**，然后点击**下一步**。
       2. 在**属性合同**中，选择 **SAML\_SUBJECT**，然后使用服务器将在断言中发送的以下必需用户属性集更新**扩展合同**字段：
          - 电子邮件
          - given\_name
          - family\_name
       3. 点击**下一步**。
       4. 在**身份验证源映射**中，点击**映射新适配器实例**。
          1. 在**适配器实例**中，选择 **PingOneIdpAdapter**，然后点击**下一步**。
          2. 在**映射方法**中，选择**在 SAML 断言中仅使用适配器合同值**，然后点击**下一步**。
          3. 在**属性合同履行**中，更新**属性合同**，具体如下：
             - **SAML\_SUBJECT**：源 - **适配器**，值 - **username**
             - **email**：源 - **适配器**，值 - email
             - **family\_name**：源 - **适配器**，值 - name.family
             - **given\_name**：源 - **适配器**，值 - name.given
          4. 点击**下一步**。
          5. 在**发行标准**中，根据需要更新字段或将其留空，然后点击**下一步**。
          6. 检查**摘要**中的详细信息，然后点击**完成**。
       5. 在**身份验证源映射**中，点击**下一步**。
       6. 检查**摘要**中的详细信息，然后点击**完成**。

:::Paragraph{indent="2"}
在**断言创建**中，点击**下一步**。
:::

:::Paragraph{listStyleType="decimal" listStart="5" indent="2"}
在**协议设置**中，点击**配置协议设置**，以设置通过 SSO 访问 SP 合作伙伴站点的 SAML 断言。
:::

:::Paragraph{listStyleType="decimal" indent="3"}
在**断言消费者服务 URL** 中，从 Neurons 平台复制**断言客户服务 URL** 并将其粘贴到 **PingFederate 管理员**门户的“端点 URL”字段中。
:::

:::Paragraph{listStyleType="decimal" listStart="2" indent="3"}
从“绑定”下拉菜单中选择 **POST**，然后点击**添加** > **下一步**。
:::

:::Paragraph{listStyleType="decimal" listStart="3" indent="3"}
在**允许的 SAML 绑定**中，选择 **POST**，然后点击**下一步**。
:::

:::Paragraph{listStyleType="decimal" listStart="4" indent="3"}
在**签名策略**中，选择**根据需要签名响应**，然后点击**下一步**。
:::

:::Paragraph{listStyleType="decimal" listStart="5" indent="3"}
在**加密策略**中，选择**无**，然后点击**下一步**。
:::

:::Paragraph{listStyleType="decimal" listStart="6" indent="3"}
检查**摘要**中的详细信息，然后点击**完成**。
:::

:::Paragraph{indent="2"}
在**协议设置**中，点击**下一步**。
:::

:::Paragraph{listStyleType="decimal" listStart="7" indent="2"}
检查**摘要**中的详细信息，然后点击**完成**。
:::

12. 在**浏览器 SSO**中，点击**下一步**。
13. 在**凭据**中，点击**配置凭据**以设置“数字签名”设置。
    1. 从**签名证书**下拉列表中选择证书。
    2. 保留**辅助签名证书**和**签名算法**的字段值，然后点击**下一步**。
    3. 检查**摘要**中的详细信息，然后点击**保存**。
14. 在**凭据**中，点击**下一步**。
15. 检查**激活和摘要**中的详细信息，然后点击**完成**。 **SP 连接**页面随即显示。
16. 针对配置的新连接，点击**操作**下的**选择操作** > **导出元数据**。
17. 在**元数据签名**中，从**签名证书**下拉列表中选择证书。
18. 从**签名算法**下拉列表中选择算法，然后点击**下一步**。
19. 选择**导出**。 元数据文件至此下载完成。
20. 导航到已打开的 Ivanti Neurons 平台的**启用外部身份验证**页面，然后点击**选择文件**。
21. 打开下载的元数据文件，然后点击**上传**。
22. 点击**继续**以验证设置。
::::

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

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

1. 在**验证连接设置**页面上，点击**验证设置**。 组织的登录页面上随即打开一个新选项卡。 输入 PingFederate 凭据并登录。
2. 返回**验证连接设置**页面，然后选中复选框以确认登录成功。
   PingFederate 现已配置但未启用。 要启用，需要转换 Ivanti Neurons 平台账户，改为使用 PingFederate。
3. 点击**继续**以继续在**转换 Ivanti Neurons 平台账户**页面上执行后续操作。
:::

:::ExpandableHeading
## 验证故障排除

- **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 凭据登录。
:::

## 配置自动配置

启用自动配置将自动向 PingFederate SP 连接中的所有成员授予对 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 平台）

1. 在 Ivanti Neurons 平台中，导航至**管理员** > **身份验证**。
   **身份验证**页面随即显示。
2. 在**外部身份验证**部分中，点击**操作&#x20;**>**&#x20;更新元数据**。
   **更新 SAML 元数据**屏幕随即显示。
3. 在 **PingFederate 配置设置**中，点击**选择文件**。
4. 打开下载的元数据文件，然后点击**上传**。
5. 点击**继续**以验证设置。
6. 在**验证新的 SAML 元数据**页面上，点击**验证 SAML 元数据**。
7. 组织的登录页面上随即打开一个新选项卡。 输入凭据并登录。
   验证会自动进行。 如果登录成功，系统会显示确认屏幕。
8. 返回**验证新 SAML 元数据**页面，然后选中该复选框以确认登录成功。
9. 点击**继续**以继续在**保存新 SAML 元数据**页面上执行后续操作。
10. 点击**保存更改**以完成流程。
    随即收到确认已成功更新元数据的通知。

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

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