OpenPortal认证计费系统-用户手册 · 扩展功能

适用系统：OpenPortalServer V6 后台 — 扩展功能

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

一、模块概述

扩展功能是按需启用的增值能力，用不到时无需配置。

这些功能都需要额外的硬件或第三方服务（摄像头、阿里云账号、任子行平台）。没有对应服务时不要随意启用，启用后用户可能无法完成认证。

二、浏览器指纹设置

使用要点

• 指纹校验用于防止「同一账号在多个浏览器间共享」。
• 启用前确认认证页的兼容性：部分老设备或内嵌浏览器会被误判。
• 遇用户反馈「换了浏览器就上不了网」时，先检查这里的开关。

三、题库与答题

用于「答题认证」场景：用户需答对题目才能上网。

3.1 题库分类

查询条件：排序、ID、名称、备注。

操作按钮：删除勾选、删除全部、添加、刷新、查询、数据设置、确定（分页跳转）。

列表字段：编号、name（分类名）、description（备注）、操作（修改、删除）。

系统自带一个「默认」分类，不能删除也不建议改名；其他分类按业务需要新建。

添加 / 修改分类

填写后点「保存」，返回列表确认；点「返回」放弃修改。

3.2 题库

查询条件：排序、ID、题库类型、问题。

操作按钮：删除勾选、删除全部、按搜索结果删除、添加、导入、刷新、查询、数据设置、确定。

列表字段：编号、分类、问题、答案、A、B、C、D、统计、操作（查看、修改、删除）。

添加 / 修改题目

批量导入题目

1. 点「模板下载」取得 Excel 模板。
2. 按模板列填写题目、选项与正确答案。
3. 选择文件后点「提交」。

导入不会覆盖已有题目，重复导入可能产生重复题，导入前先导出核对。

3.3 答题记录

查询条件：排序、ID、题库类型、问题、是否正确、姓名、电话、IP、MAC。

操作按钮：删除勾选、删除全部、按搜索结果删除、刷新、查询、数据设置、确定。

列表字段：编号、分类、问题、答案、A、B、C、D、是否正确、用户选择、用户答案、姓名、电话、IP、MAC、记录时间、操作。

用途

• 用户反馈「答对了却说错」时，用 IP、MAC 定位到记录，核对「用户选择」与「答案」是否一致。
• 「是否正确」是判断认证放行与否的直接依据。
• 记录量大时可先按时间与人筛选，再按需导出留档。

四、视频广告

用户认证之前先观看一段视频，常与广告或安全教育结合使用。

4.1 视频广告管理

查询条件：排序、ID、名称、是否投放。

操作按钮：删除勾选、删除全部、按搜索结果删除、添加、刷新、查询、数据设置、确定。

列表字段：编号、名称、备注、创建时间、是否投放、视频地址、视频时长、统计、操作。

添加 / 修改视频

操作步骤

1. 点「添加」，填写名称与备注。
2. 「是否投放」先选「否」，等验证通过后再改「是」。
3. 填写视频时长（必须与实际时长一致，否则播放判断会出错）。
4. 上传视频文件，保存。
5. 前台验证播放是否正常、能否正常跳过进入认证页。

注意事项

• 视频文件建议压缩到合理体积，过大时首屏加载很慢，用户会以为打不开。
• 上传格式以浏览器可播放的常见格式为准，避免使用冷门封装。
• 修改视频后「是否投放」的开关会被带出，保存前确认一遍。

4.2 视频广告记录

查询条件：排序、ID、视频名称、姓名、电话、IP、MAC。

列表字段：编号、视频名称、备注、视频创建时间、视频地址、姓名、电话、IP、MAC、记录时间、操作。

用途：核实「用户声称看过视频」是否属实；统计广告触达情况。

五、阿里云设置

页面标题为「阿里云API设置」，提供人脸 / 身份证识别、实名校验、手机归属地查询与文件存储参数。识别可以由阿里云完成，也可以由本地引擎完成：前者需要阿里云账号与外网，后者在本机或内网完成、不产生按次费用。

配置步骤

1. 先定「校验引擎」：

• 选「阿里云（需外网）」：在阿里云控制台创建访问密钥，取得 KeyID 与 KeySecret 填入。
• 选「本地 FaceOcrService」：填写本地服务地址（必填）与本地服务令牌，令牌须与服务端配置一致。

1. 按需设置「活体检测」「自动清理」「实名校验」；两个阈值都先用默认值，验证通过后再微调。
2. 「是否启用」先保持「否」，填好其余项并保存。
3. 确认服务器能访问对应引擎（阿里云走外网 / 本地服务地址能连通）后，再把「是否启用」改为「是」。
4. 用测试账号走一次实名或人脸流程验证。

注意事项

• 密钥填写错误时，启用后所有需要实名的用户都会认证失败，属于最典型的事故来源。
• 人脸阈值调得过高会大量误判为不通过，建议先用默认建议值；阿里云阈值与本地阈值互相独立，不要两边套用同一个数。
• 内网环境无法访问外网时，选「阿里云」引擎或把「手机归属地」设为「仅阿里云」都会失败，此时应改用本地链路。
• 关闭「活体检测」是有代价的：认证页会多出「从相册选择照片」，等于允许用相册里的静止照片过脸。只在摄像头确实不可用（如纯 HTTP 环境、老旧设备）时才关闭。
• 切换校验引擎后，此前已采集的人脸需要重新采集——两套引擎的人脸特征不通用。

六、任子行对接设置

与任子行审计平台对接，把上网日志报送出去。

配置步骤

1. 从任子行平台方取得地址、端口、共享密钥。
2. 在本页逐项填写。
3. 保存后先用「是否启用 = 否」观察一天，确认不影响本地认证。
4. 再启用并到任子行平台侧确认数据是否收到。

共享密钥不一致会导致对接静默失败（本地无报错、对端无数据），排查时优先核对密钥与端口。

七、Vlan-Domain 映射

用于「不同 VLAN 对应不同域名/域」的场景（多租户或多分支机构）。

7.1 列表

查询条件：名称、Vlan、Domain。

操作按钮：删除勾选、删除全部、添加、刷新、查询、数据设置、确定。

列表字段：编号、名称、Vlan、Domain、备注、操作（修改、删除）。

7.2 添加 / 修改

使用要点

• VLAN 号必须与接入设备上实际使用的 VLAN 一致，否则映射不生效。
• 一个 VLAN 只应配置一条映射，重复配置时以最先匹配的为准。
• 变更 VLAN 规划后，这里的映射要同步更新。

八、常见问题