---
title: 配置 LDAP 服务器
slug: nmdm/admin-guide/zhcn/vnow/ldap
createdAt: 2026-09-24T15:38:04.000Z
---

## 许可证： Silver

配置 LDAP 服务器和 Connector 允许您从公司目录中导入用户和组。 您至少安装一个 Connector 后，便可添加一个或多个 LDAP 服务器。

添加 LDAP 服务器意味着配置：

- 同 LDAP 服务器的*连接*
- 查看目标目录数据必需的*搜索条件*
- 要*导入*的目录部分
- 是否在所选目录部分自动*邀请用户*

添加 LDAP 服务器后，您可以返回到此页面[编辑 LDAP 服务器信息](docId\:exSPj1aAaXDCkpWN5ofnF)或[更改所选 LDAP 用户](docId\:exSPj1aAaXDCkpWN5ofnF)。

:::hint{type="info"}
在配置 LDAP 用户后，必须导入 LDAP 用户。 请参见[导入 LDAP 用户](docId\:exSPj1aAaXDCkpWN5ofnF)。
LDAP 用户名（例如本地用户名）必须全局唯一。 请确认用户没有拥有相同用户名的本地帐户；或者对于拥有多位租户的组织，请确认用户名没有与其他租户关联。
:::

## 添加 LDAP 服务器

**程序**

1. 单击 **+ 添加服务器**。
2. 提供以下信息：
3. 单击**测试连接并继续**。

| **设置** | **流程**                                                                                                                |
| ------ | --------------------------------------------------------------------------------------------------------------------- |
| 名称     | 输入用于识别此服务器的名称。                                                                                                        |
| 说明     | 输入阐明此服务器目的的说明。                                                                                                        |
| 目录 URL | 输入目录的 URL。 使用以下格式之一：<br />ldap\://IP address 或<br />ldaps\://IP address 或<br />示例：ldap\://myserver1.mycompany.com:389 |
| 用户 ID  | 输入具有以下特征的账户的用户 ID：<br />- 由 LDAP 服务器管理<br />- 可以绑定至 LDAP 服务器，并能搜索用户、组和组织单位的子树<br />这通常是一个具有目录管理员证书（DN 或可分辨名称和密码）的帐号。  |
| 密码     | 输入帐号的密码。                                                                                                              |
| 确认密码   | 重新输入帐号的密码。                                                                                                            |
| 目录类型   | 从所支持的目录列表中选择目录类型。<br />- Microsoft Active Directory<br />- 打开 LDAP<br />- 其他（与 Open LDAP 兼容）                          |

4. 此步骤验证您目前所提供的信息。

- 如果信息证明有效，则服务会检索 LDAP 命名上下文，用此填写下一页中的一些字段。
- 如果 LDAP URL 无法连接，您可能会继续设置后续步骤。 但这可能会导致功能受限，直到解决连接。

完成剩余设置：

5. 单击**下一步**。

| 设置                                     | 流程                                                                                                                                                                                                                    |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 目录故障转移 URL                             | 输入二级目录的 URL。 使用以下格式：<br />ldap\://IP address 或<br />示例：ldap\://myserver2.mycompany.com:389                                                                                                                            |
| 同步间隔                                   | 输入每次尝试从 LDAP 服务器同步 LDAP 数据之间的时间段。 默认值为 15 分钟。 一旦您成功同步所有目标 LDAP 数据，并确认您的 LDAP 设置满足您的需求后，考虑增大间隔。                                                                                                                        |
| [启用同步放弃](docId\:exSPj1aAaXDCkpWN5ofnF) | 如果重新加载的数据集显著下降，选择此项可自动放弃同步数据。 此选项可确保 LDAP 系统上的一部分不正常行为不会对服务造成不必要的破坏性更新，以及从注册设备上移除配置。 如果您打算对 LDAP 设置或 LDAP 服务器进行大改动，请确保未选择此选项。                                                                                         |
| 启用该 LDAP 服务器                           | 选择此项可让您的服务使用此 LDAP 服务器。 如果您想要停用此 LDAP 服务器或将其从服务中移除，请清除此设置。 虽然配置的故障转移至第二个 LDAP 服务器将自动替换此服务器，但使用此选项可使您提前计划并避免在故障转移期间暂时缺少连接性。                                                                                            |
| 在导入用户自动邀请                              | 选择在从 LDAP 服务器导入时自动将邀请发送到用户。                                                                                                                                                                                           |
| 上传 CA 证书                               | 单击**选择文件**，以上载由在此 LDAP 服务器中安装的 CA 颁发的 TLS 证书。 您可以上传多个 CA 证书。                                                                                                                                                          |
| 查找参照                                   | 仅在使用多林域时适用。 此选项表明当目标域控制器没有请求对象的副本时，您是否要使用备用域控制器。<br />- 如果您要使用推荐控制器，请选择**跟随**。<br />- 如果您不使用备用域控制器，请选择**忽略**。<br />- 目前，**丢弃**选项与**忽略**的效果相同。<br />选择**遵循**会延迟 LDAP 身份验证。                                             |
| 搜索结果超时                                 | 如果您浏览从 LDAP 服务器同步的数据时，发现性能问题或结果不完整，请延长此超时时间。                                                                                                                                                                          |
| 搜索结果计数                                 | 设置为应从 LDAP 服务器中一次返回的最大记录数。 需要更改此设置以提高性能的情况包括：<br />- LDAP 服务器的位置远离高延迟链接，或在高延迟链接之后。 此种情况下，检索大搜索结果比检索小搜索结果所需的时间长，因此定义一个较小的集可使您更快地查看更新数据的子集。<br />- LDAP 是巨大的，每次搜索均会返回巨大的结果集。 此种情况下，如果性能不是问题，定义一个较大的结果集便能通过较少次的搜索返回所有数据。 |

:::hint{type="info"}
对于沙盒环境，LDAP 同步间隔不能小于 8 小时。
:::

6. 按照以下指导方针配置与 LDAP 服务器的集成：
7. 单击**浏览**或**搜索**。

| **设置**      | **流程**                                                                                                                                                            |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 组成员格式       | 选择 **DN** 或 **UID**，以指示是在搜索中使用可分辨名称还是用户 ID。                                                                                                                       |
| *OU 搜索属性*   | 指定在组织单位级别进行搜索的条件。                                                                                                                                                 |
| 基本 DN       | 输入您希望您的搜索根源或起点所在的起始级别的可分辨名称。 您的选择决定一些其他字段的默认值，如有必要，您可以对其进行更改。                                                                                                     |
| 对象 GUID     | 如有必要，更改默认值以同您的 LDAP 环境匹配。 这是唯一跨越时间和 OU 名称更改识别组织单位的属性。                                                                                                             |
| 属性名称        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 说明          | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 属性 DN       | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 搜索筛选        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 搜索范围        | 选择要作为目标的 LDAP 层次结构部分：<br />- **基本**（仅搜索基本条目的级别）<br />- **一级**（搜索基本之下的级别）<br />- **子树**（搜索基本 DN 之下的目录信息树中的 子树）                                                     |
| *用户搜索属性*    | 指定在特定目录级别搜索用户的条件。                                                                                                                                                 |
| 基本 DN       | 输入您希望进行搜索的起始级别的可分辨名称。                                                                                                                                             |
| 属性 UID      | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 对象 GUID     | 如有必要，更改默认值以同您的 LDAP 环境匹配。 这是唯一跨越时间和用户名称更改识别用户的属性。                                                                                                                 |
| 属性 DN       | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 名字          | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 姓氏          | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 显示名称        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 电子邮件地址      | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 主体名称        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 区域设置        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 成员          | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 搜索筛选        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 搜索范围        | 选择要作为目标的 LDAP 层次结构部分：<br />- **基本**（仅搜索基本条目的级别）<br />- **一级**（搜索基本之下的级别）<br />- **子树**（搜索基本 DN 之下的目录信息树中的 子树）                                                     |
| 受管 Apple ID | 选择以同步 LDAP 用户的受管 Apple ID。<br />- **无**<br />- **模式** -<br />- **用户电子邮件地址**<br />- **userUPN**<br />或者，选择**包含“appleid”子域**选项，以避免与现有 Apple ID 冲突。                  |
| +添加自定义属性    | （可选）从目录服务中指定最多 7 个要用于设备管理的自定义用户属性。 每个属性随后可被支持变量的配置字段中的 $ 引用。<br />**重要信息：**&#x4F7F;用此选项需要在所有 LDAP 服务器执行中使用统一的自定义属性。 如果执行中包含的 LDAP 服务器未使用此属性，则取决于该属性的功能可能无法发挥预期作用。 |
| *组搜索属性*     |                                                                                                                                                                   |
| 基本 DN       | 输入您希望进行搜索的起始级别的可分辨名称。                                                                                                                                             |
| 对象 GUID     | 如有必要，更改默认值以同您的 LDAP 环境匹配。 这是唯一跨越时间和组名更改识别组的属性。                                                                                                                    |
| 属性 DN       | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 属性名称        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 说明          | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 成员          | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 搜索筛选        | 如有必要，更改默认值以同您的 LDAP 环境匹配。                                                                                                                                         |
| 搜索范围        | 选择要作为目标的 LDAP 层次结构部分：<br />- **基本**（仅搜索基本条目的级别）<br />- **一级**（搜索基本之下的级别）<br />- **子树**（搜索基本 DN 之下的目录信息树中的 子树）                                                     |

8. 确认您的配置返回期望数据。
9. 您可以通过在目中浏览或搜索已知项完成此操作。

单击**下一步**。

## 删除自定义 LDAP 属性

您可以删除自定义 LDAP 属性，并从关联的用户或设备中删除其值。

**程序**

1. 转至**管理员 > 属性**。
2. 在**自定义属性**部分，单击应删除的 LDAP 属性旁边的**删除**链接。 将显示“确认”窗口。
3. 点击**删除**确认删除。

:::hint{type="info"}
**删除**按钮默认禁用。您应该选中**我了解删除自定义属性不可逆**选项中的复选框，以启用**删除**按钮。
:::

## 编辑 LDAP 服务器信息

**程序**

1. 转至**管理 > LDAP**。
2. 在 LDAP 服务器条目中，从**操作**列选择**编辑**图标，以查看“连接 LDAP 服务器”页面。
3. 进行必要更改。
4. 单击**测试连接并继续**。
   如果 LDAP URL 无法连接，您可能会继续设置后续步骤。 但这可能会导致功能受限，直到解决连接。
5. 单击**浏览**或**搜索**。
6. 确认您的配置返回期望数据。
   您可以通过在目中浏览或搜索已知项完成此操作。
7. 单击**完成**。

## 导入 LDAP 用户

**程序**

1. 转到**用户**。
2. 单击 **+ 添加 > 从 LDAP 邀请用户**。
3. 在 LDAP 服务器条目中单击**选择用户**。
4. 在“添加 LDAP 用户”页面，在搜索字段中输入用户、小组或 OU 的名称。
5. 要添加新用户或小组，单击您想要添加条目旁边的 **+ 添加**。
6. 单击**下一步**。
7. 选择是否发送邀请：
   - 无邀请
     要在稍后发送邀请，转到**用户 > 用户**并选择**操作 > 发送邀请**，以发送邀请。
   - 全部邀请

单击**完成**。

## 更新所选的用户、组或组织单位

**程序**

1. 转至**管理 > LDAP**。
2. 在 LDAP 服务器条目中，从**操作**列选择**管理用户**图标，以查看添加 LDAP 用户页面。
3. 要添加新用户或小组，在搜索字段中输入用户名或小组名。
4. 单击您想要添加条目旁边的 **+ 添加**。
5. 要移除用户、小组或 OU，单击您想要删除条目旁边的移除图标。
6. 单击**完成**。

## 启用 LDAP 同步丢弃通知

启用 LDAP 同步丢弃通知有助于防止因无意中对 LDAP 环境进行大规模更改而导致的中断。

**程序**

1. 转至**管理 > LDAP**。
2. 在 LDAP 服务器条目中，从**操作**列选择**编辑**图标，以查看“连接 LDAP 服务器”页面。
3. 选中**启用同步丢弃**复选框。
4. 为重新加载 LDAP 数据的百分比输入值，以触发同步放弃。
5. 单击**测试连接并继续**。
   如果 LDAP URL 无法连接，您可能会继续设置后续步骤。 但这可能会导致功能受限，直到解决连接。
6. 单击**完成**。
7. 在 LDAP 服务器条目中，单击**立即同步**图标。
   从 LDAP 同步到 Ivanti Neurons for MDM 的变化差异超过已设置的放弃百分比时，则会生成“警告”通知。 在更改还原到设置百分比之下的值以后，则会清除通知。

| 触发器        | 严重等级 | 通知类型 | 组件类型 | 组件         |
| ---------- | ---- | ---- | ---- | ---------- |
| LDAP 同步放弃  | 警告   | 数据同步 | LDAP | LDAP 服务器名称 |
| LDAP 同步已恢复 | 信息   | 数据同步 | LDAP | LDAP 服务器名称 |

当一个或多个用户记录无法从 LDAP 同步时，将生成部分同步丢弃通知。 在这种情况下，CSV 文件作为附件包含在一起，其中包含无法同步的用户列表。 如果用户由于缺少属性而被丢弃，则缺失属性列表也会包含在导出的 CSV 文件中。

## 从 LDAP 服务器同步更改

在“LDAP”页面中，单击 LDAP 服务器条目中的**立即同步**图标。

:::hint{type="info"}
如果显示名称超过 128 个字符，LDAP 同步将忽略此类用户，并继续与其他用户或用户组同步。
:::

## 排除连接至 LDAPS 服务器的故障

若您放在连接至 LDAPS (LDAP over SSL) 服务器时遇到问题，您可能是碰到与证书相关的问题。

要解决此问题：

- 核实您并未在 LDAPS 服务器上使用自签名证书。
- 核实 LDAPS 证书尚未到期或被撤销。 此外，检查主机名是否不匹配。

在验证后，等待自动 LDAP 同步，或在 LDAP 服务器条目中使用**管理员 > LDAP > 立即同步**图标手动同步。

如果您未看到 LDAP 页面，这可能是您没有所需权限。 您需要以下[角色](docId\:IFE0x1kfrn3_BxIl1pKfx)之一：

- 系统管理
- 系统只读
