OpenPortal认证计费系统-用户手册 · AD域-LDAP管理

适用系统：OpenPortalServer V6 后台 — AD域-LDAP管理

手册说明：本文所有截图取自系统实际界面并按页面原样展示（未做任何遮挡），实际参数以生产环境为准。

一、模块概述

本模块用于把 Windows AD 域（或标准 LDAP 目录）中的账号接入上网认证：先配置域服务器连接参数，再把域账号查询出来或批量导入，用户即可用域账号上网。

使用前提

1. 已有可访问的 AD 域服务器（或 LDAP 服务），且认证服务器能连通其端口。
2. 有一个具备查询权限的域账号，用于系统连接目录。
3. 已明确账号在目录中的组织单位（OU）与匹配字段。

三项操作建议按「设置 → 导入/添加 → 查询核对」的顺序进行。

二、AD 域设置

2.1 页面说明

页面提示「本页面为 AD 域设置页面！」，下方为连接参数表单，底部为「保存」「返回」按钮。

2.2 参数说明

「类型」决定了系统用哪个属性去匹配登录账号（例如用 uid 或 sAMAccountName）。选择错误会导致域账号能连上服务器但查不到人。

2.3 操作步骤

1. 填写 AD 地址与端口号，确认服务器网络可达。
2. 填写连接账户与密码。
3. 填写 BASE 与 Domain。
4. 选择合适的「类型」。
5. 点击「保存」。
6. 到「AD 域管理」页面点「查询」，能看到域账号列表即表示配置成功。

2.4 注意事项

• 修改密码时才在密码框输入；只想改其他参数时保持密码为空，否则会把密码改成空值。
• 保存后必须回到「AD 域管理」实测一次查询，否则配置错误无法及时发现。
• 若提示连接失败，依次排查：网络是否可达 → 端口是否开放 → 账号密码是否正确 → BASE 是否写错。

三、AD 域管理

3.1 页面结构

页面分为左右两部分：

• 左侧「组织结构」：展示目录树的节点（根节点显示为 BASE），点击可切换查询范围。
• 右侧「操作选项」：查询条件、操作按钮与账号列表。

3.2 查询条件

填好后点「查询」；点「刷新」重新加载当前结果。

3.3 账号列表字段

3.4 操作按钮

3.5 使用步骤

1. 打开页面，确认左侧「组织结构」能展开目录节点。
2. 在「用户名」或「OU」填入条件，点击「查询」。
3. 核对列表中的用户名、姓名、分组是否正确。
4. 需要补充个别账号时点「账户添加」。
5. 需要清理时，勾选目标行点「删除勾选」，或按分组执行「按组删除」。

3.6 注意事项

• 列表数据来自域服务器，删除的是系统侧的账号记录，不会删除 AD 域中真实存在的用户。
• 「按组删除」不要求逐行勾选，误操作影响面大，执行前先查询确认该分组的全部账号。
• 「DN」由目录结构决定，不要当作普通字段看待，也不要用于登录认证。

四、AD 域账户导入

用于一次性导入大量域账号，避免逐个添加。

4.1 页面说明

页面上方展示上一次导入的结果统计与时间，中间是「模板下载」，下方是文件选择与「提交」按钮。

4.2 操作步骤

1. 点击「模板下载」，得到标准 Excel 模板。
2. 严格按模板的表头与格式填写账号信息，不要增删列、不要改动表头文字。
3. 点击「选择文件」，选中填好的 Excel。
4. 点击「提交」，等待导入完成。
5. 查看页面顶部的导入结果提示：「上一次共计导入 N 条，失败 M 条」。
6. 若失败条数不为 0，点击「查看上一次导入失败列表」，按失败原因逐条修正后重新导入。

4.3 注意事项

• 文件格式必须是 Excel（.xls / .xlsx），其他格式无法识别。
• 模板中的必填列必须填写，留空会记为失败。
• 导入是新增行为：已存在的账号可能被跳过或覆盖，重复导入前先确认。
• 单次导入记录条数建议控制在一万条以内，过大请分批导入。

五、常见问题