---
title: OneLogin 身份验证 (SAML)
slug: neurons/help/zh_cn/onelogin-saml
createdAt: 2026-09-07T07:01:36.521Z
---

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

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

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

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

::::ExpandableHeading
## 第 2 步 - OneLogin 应用程序设置（OneLogin 控制台）

1. 登录 **OneLogin** 控制台。
2. 导航至**应用程序&#x20;**> **应用程序**。
3. 点击**添加应用程序**以添加新应用程序。
   **查找应用程序**屏幕随即显示。
4. 选择 **SAML 自定义连接器（高级）**。
   出现**添加 SAML 自定义连接器（高级）**&#x5C4F;幕。
5. 根据需要输入描述，然后点击**保存**。
6. 在**配置**里打开的 Ivanti Neurons 标签页中，输入以下字段的值：
   1. **受众（实体 ID）：实体 ID。**
   2. **收件人：断言消费者服务 URL。**
   3. **ACS（消费者）URL 验证器：断言消费者服务 URL**
   4. **ACS（消费者）URL：断言消费者服务 URL。**
7. 单击**保存**。
8. 导航到**参数**并更新 SAML 自定义连接器（高级）字段 ，如下所示。
   1. 点击 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/CF1h-xL9GmswxXVaUpsqr_add-application.png" alt caption size="10" width="36" height="38"}。 输入字段名称为 **email** 并选择**包含在 SAML 断言中** > **保存**。 在 **编辑字段电子邮件**中，将**值**设置为**电子邮件** > **保存**。
   2. 点击 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/CF1h-xL9GmswxXVaUpsqr_add-application.png" alt caption size="10" width="36" height="38"}。 输入字段名称为 **family\_name** 并选择**包含在 SAML 断言中** > **保存**。 在**编辑字段 family\_name** 中，将**值**设置为**姓氏** > **保存**。
   3. 点击 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/CF1h-xL9GmswxXVaUpsqr_add-application.png" alt caption size="10" width="36" height="38"}。 输入字段名称为 **given\_name** 并选择**包含在 SAML 断言中** > **保存**。 在**编辑字段 given\_name**中，将**值**设置为**名字** > **保存**。

      :::hint{type="info"}
      如果 **值**字段显示为 **无默认值**，请刷新页面。
      :::
9. 导航至 **SSO** > **更多操作。**&#x70B9;击 **SAML 元数据**。
   元数据文件至此下载完成。
10. 导航到已打开的 Ivanti Neurons 平台的**启用外部身份验证**页面，然后点击**选择文件**。
11. 打开下载的元数据文件，然后点击**上传**。
12. 点击**继续**以验证设置。
::::

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

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

1. 在**验证连接设置**页面上，点击**验证设置**。
   验证会自动进行。 如果登录成功，系统会显示确认屏幕。
2. 返回**验证连接设置**页面，然后选中复选框以确认登录成功。
   OneLogin 现已配置但未启用。 要启用，需要转换您的 Ivanti Neurons 平台帐户，改为使用 OneLogin。
3. 点击**继续**以继续在**转换您的 Ivanti Neurons 平台帐户**页面上执行后续操作。
:::

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

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

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

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

## 配置自动配置

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

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

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

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

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

## （可选）更新元数据（Ivanti Neurons 平台）

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

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

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