OpenPortal认证计费系统-用户手册 · Portal 管理

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

一、模块概述

Portal 管理负责认证入口的一切配置：设备怎么连、用哪种认证方式、短信 / 微信公众号·小程序 / 钉钉企微飞书怎么对接、无感知多久失效。

页面	页面地址	用途
设备对接默认设置	`/portalconfig/show.action`	全局的 Portal 对接参数与认证方式开关
多 BAS 对接设置	`/portalbas/list.action`	为不同接入设备配置独立参数
Url 自定义参数携带设置	`/portalurlparameter/show.action`	认证 URL 携带哪些用户信息
微信公众号/小程序对接设置	`/portalweixinwifi/list.action`	微信公众号与小程序参数
钉钉企微飞书设置	`/portaldingding/list.action`	钉钉、企业微信、企微私有化、飞书参数
短信网关设置	`/portalsmsapi/list.action`	短信服务商参数
短信发送日志	`/portalsmslogs/list.action`	短信发送明细
每日最大时长设置	`/portalonlinelimit/show.action`	各认证方式的每日上网时长上限
无感知认证设置	`/portalautologin/show.action`	各认证方式的无感知时长与开关
无感知缓存列表	`/portalautologin/list.action`	已缓存的无感知终端
终端厂商信息管理	`/portalagent/list.action`	MAC 前缀与厂商对应关系
终端主机名管理	`/portalagentdevice/list.action`	按 MAC 指定主机名

二、设备对接默认设置

页面上方红字提示：「本页面为设备对接默认设置页面，请保证与 AC BAS 等设备配置信息一致！」 这是全平台最重要的一处对接配置。

2.1 基础参数

参数	说明
BAS IP	接入设备的地址，必须与设备实际配置一致
BAS 端口	Portal 协议端口
共享密钥	与设备约定的密钥，两端必须完全一致
公共账号 / 公共密码	一键认证等场景使用的公共账号
设备类型	三个下拉组合：设备厂商类型（如「标准」）、协议版本（如「V2/IMC」）、认证算法（如「CHAP」）
连接超时设置	与设备交互的超时时间，默认 4 秒
Portal 计费	关闭 / 开启
电脑登录	允许 / 禁止电脑终端登录
延迟认证	关闭 / 开启；开启后需填写「延迟时长（秒）」
仅 NTF 同步	是 / 否
Portal 心跳	是 / 否
AD 域校验	是 / 否，开启后需先在「AD 域-LDAP 管理」配好域服务器
页面模版	默认使用的认证页面模板
短信接口	默认使用的短信网关
钉钉企微飞书	默认使用的对接平台，如「Portal 平台」

设备类型三个下拉必须与设备端一致，这是「能连上但认证总是失败」的最常见原因。

2.2 认证方式开关表

页面下半部分是表格，逐行配置每种认证方式：

列	说明
是否启用	勾选表示前台页面提供该认证方式
认证方式	一键认证、接入用户认证、Radius 认证、APP 认证、短信认证、微信公众号/小程序认证、钉钉企微飞书认证、访客认证
公共账户 / 公共密码	该认证方式专用的公共账号（可留空）
允许时长	该认证方式单次上网的允许时长，单位分钟
认证成功后跳转 URL	认证通过后跳转到的页面地址

配置建议

先按设备手册填好基础参数，保存。
用一台终端走一次认证，确认能拿到认证页。
再逐行打开需要的认证方式，避免一次改太多难以定位问题。
「认证成功后跳转 URL」留空时使用系统默认跳转，填写时会覆盖默认行为。

三、多 BAS 对接设置

当网络中存在多台接入设备且参数不同时，用本功能为每台设备单独配置，替代默认设置。

3.1 列表

列	说明
编号 / BAS 名称 / BAS IP / 共享密钥 / 设备类型 / 协议版本 / 认证类型	设备的基本对接参数
连接超时 / 认证页面 / 短信接口 / 钉钉企微飞书	该设备使用的页面与接口
Portal 计费 / 电脑认证 / 延迟认证 / 延迟时长 / NTF / 心跳 / AD 校验	各功能开关
操作	修改、删除入口

查询条件为「BAS 名称」「BAS IP」；按钮包括删除勾选、添加、刷新、查询、数据设置。

3.2 添加 / 修改

字段与「设备对接默认设置」一致，额外增加 BAS 名称，并同样包含「是否启用 / 认证方式 / 公共账户 / 公共密码 / 允许时长 / 认证成功后跳转 URL」的认证方式表格。

使用要点

台账里每台设备一条记录，名称建议写成「楼栋-设备型号-IP」。
已单独配置的设备不再走默认设置，排查问题时先确认这台设备是否在多 BAS 列表中。
删除记录前确认该设备已经下线，否则认证会立即失效。

四、Url 自定义参数携带设置

页面上方提示：「本页面为 Url 自定义参数携带设置页面，请保证与 AC BAS 等设备 Url 参数配置信息一致！」

参数	说明
BAS 名称	该配置对应的设备名称（必填）
BAS IP	设备地址
用户 IP / 用户 MAC	认证 URL 中携带的用户地址与物理地址
SSID	无线信号名称
AP MAC / AP IP	无线接入点信息
用户访问地址	用户原本要访问的地址

这里的值必须与设备端发送的参数名一致，写错会导致认证页拿不到用户信息（表现为页面空白或认证失败）。

五、微信公众号/小程序对接设置

微信侧有三条认证入口 —— 微信连 WiFi、微信小程序、微信公众号 —— 在本系统里共用同一套对接参数。菜单名为「微信公众号/小程序」，页面标题为「微信公众号/小程序对接设置」。

5.1 列表

查询条件：BAS IP、SSID、微信号、AppID。

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

列	说明
编号 / BAS IP / SSID	该配置适用的设备与信号
微信号（小程序名称） / 名称（小程序标题）	公众号或小程序信息
AppID / 原始ID	微信平台分配的标识
放行时长	认证后允许上网的时长
操作	修改、删除入口

5.2 添加 / 修改

字段	说明
BASIP	适用设备地址
SSID	适用无线信号名称
微信号	页面提示标注为【小程序名称】
名称	页面提示标注为【小程序标题】
AppID / AppSecret	微信平台应用参数
原始ID	公众号原始 ID，形如 `gh_` 开头
Token	页面提示标注为【小程序跳转地址】；填写后，微信侧认证通过时跳转到该地址（覆盖系统默认跳转页），留空则用系统默认跳转
AESKey	页面提示标注为【小程序Path】，即跳转到小程序内的哪个页面
临时放行时长	认证通过后的放行时间，单位秒，备注【重启后生效】

页面上这两个字段的名称是历史命名：Token 实际存的是认证成功后的跳转地址，AESKey 实际存的是打开小程序时的 Path，按页面提示栏理解，不要与微信平台的消息校验 Token 混淆。

配置步骤

在微信公众平台 / 小程序后台取得 AppID、AppSecret；公众号另需原始 ID（gh_ 开头）。
按需填写 Token（认证成功后跳转地址，留空用系统默认）与 AESKey（小程序 Path，打开小程序时进入哪个页面）；两者均可留空，不影响公众号认证。
回到本页把参数逐项填入，保存。
用手机在对应 SSID 下走一次微信公众号/小程序认证验证。

AppSecret 与 AESKey 属于敏感信息，对外分享手册前请自行确认；本手册截图按页面原样展示，未做遮挡。

六、钉钉企微飞书设置

菜单与页面标题均为「钉钉企微飞书设置」，一个页面覆盖钉钉、企业微信、企业微信私有化、飞书四种类型。

6.1 列表

列	说明
编号 / 名称	对接配置名称
类型	钉钉 / 企业微信 / 企微私有化 / 飞书
AppKey（企业 ID）	平台侧的企业标识
AgentId	应用 AgentId（飞书可不填）
钉钉登录 AppId	钉钉登录使用的 AppId
账户绑定	是否要求绑定账号
操作	修改、删除入口

6.2 添加 / 修改

字段	说明
名称	配置名称
类型	下拉选择平台类型
AppId / AppIdSecret	应用标识与密钥
账户绑定	是否强制绑定
AgentId	应用 AgentId
AppKey / AppSecret	企业级参数
URL（私）	私有化部署时的接口地址

类型选择决定认证成功后生成的账号前缀与跳转页面，切换类型后需重新验证一次登录流程。飞书无需 AgentId。

七、短信网关与发送日志

7.1 短信网关设置

列	说明
编号 / 名称	网关名称
AppKey（gwid、accountId）	服务商分配的账号标识
模版 ID（serviceId）	短信模板 ID
签名 ID（srcTermId）	短信签名标识
公司名称	服务商或客户名称
使用次数	该网关已发送的条数
网关类型	服务商类型，如虚拟、阿里短信、爱快、移动企通信、联通一信通、移动 OpenMas、SUBMAIL、开利短信、电信 SMGP、华信短信平台
状态	启用 / 停用
多终端登录	允许 / 禁止
验证码过期	验证码有效时长，如 10 分钟
操作	修改、删除入口

添加 / 修改网关

字段	说明
名称	网关名称
URL	服务商接口地址
AppKey / Secret	服务商账号与密钥
模版 ID / 签名 ID	短信模板与签名
公司名称	展示用的公司名称
状态	启用 / 停用
类型	服务商类型，必须与接口协议匹配
多终端登录	允许 / 禁止
验证码过期	验证码有效期
短信内容	短信正文，含验证码占位

注意事项

「类型」必须与所选服务商的接口协议一致，选错会导致发送失败。
同一时间只建议启用一个网关，多个启用时以默认短信接口为准。
修改网关参数后，用「短信发送日志」确认新网关是否真正发出。

7.2 短信发送日志

列	说明
编号 / 记录时间	发送序号与时间
网关类型	实际使用的服务商
手机号	接收号码
发送内容	短信正文
操作	该行可用操作

用途：用户反馈“收不到验证码”时，先查这里确认是否发出——有记录说明是运营商或用户手机问题，无记录说明网关配置有问题。

八、每日最大时长设置

列	说明
认证方式	如短信认证、一键认证、接入用户认证、Radius 认证、APP 认证、微信公众号/小程序认证、钉钉企微飞书认证、访客认证
判断方式	时长的计算口径
每日最大时长	该认证方式每天允许上网的总时长
是否启用	是否对其实施限制
操作	修改入口

该限制按认证方式生效，与账号自身的套餐时长相互独立。开启前先与业务确认口径，避免误伤付费用户。

九、无感认证设置

9.1 设置页

参数 / 列	说明
检测周期	无感检测的时间间隔（分钟），【重启后生效】
计时方式	时长计算口径，如「天文周期」
认证方式	每种认证方式单独一行
无感知时长	该方式允许免认证的时长（分钟）
是否启用	启用 / 停用
操作	「改变状态」快速切换启用状态，「修改」调整时长

使用说明

「无感知时长」填 0 且停用时，表示该方式不做无感免认证。
想让用户一次认证后一段时间内免登录，需同时开启「是否启用」并设置大于 0 的时长。
修改检测周期后必须重启服务。

9.2 无感缓存列表

列	说明
编号 / MAC 地址	终端标识
认证方式 / 认证名称	该终端使用的认证方式
调用用户	关联的上网账号
开始时间 / 累计时长	缓存生效时间与已累计时长
操作	该行可用操作

用途

用户换设备或换账号后仍被识别为旧账号时，在这里删除对应缓存即可。
按钮包括删除勾选、删除全部、刷新、查询、数据设置。

十、终端厂商与主机名

10.1 终端厂商信息管理

按 MAC 前缀识别终端厂商，用于认证页展示或策略匹配。

列 / 字段	说明
编号 / MAC 标识 / 厂商名称	列表内容
MAC	添加时的 MAC 前缀或完整地址（必填）
厂商名称	对应厂商
按钮	删除勾选、删除全部、添加、刷新、查询、数据设置

10.2 终端主机名管理

按 MAC 指定终端的主机名，便于在在线列表中辨认设备。

列 / 字段	说明
编号 / MAC 标识 / 终端主机名	列表内容
MAC	设备物理地址（必填）
终端主机名	显示名称
按钮	删除勾选、删除全部、添加、刷新、查询、数据设置

十一、常见问题

现象	原因与处理
用户手机不弹出认证页	检查「设备对接默认设置」的 BAS IP、端口、共享密钥是否与设备一致
认证页能打开但认证总失败	重点核对「设备类型」三个下拉（厂商类型、协议版本、认证算法）是否与设备端一致
某台设备认证异常、其他正常	该设备可能配置在多 BAS 列表中，检查其独立参数
认证页地址里的用户信息为空	「Url 自定义参数携带设置」的参数名与设备端不一致
微信公众号/小程序认证报错	AppID / AppSecret / 原始ID 与微信平台不一致；或 Token（小程序跳转地址）、AESKey（小程序 Path）填错
收不到短信验证码	先查「短信发送日志」；无记录说明网关配置问题，有记录说明运营商或手机问题
短信发送失败	网关「类型」与服务商协议不匹配，或模板/签名未报备通过
用户每次都要重新认证	「无感知认证设置」中该认证方式未启用，或时长填了 0
用户换账号后仍显示旧账号	到「无感缓存列表」删除该 MAC 的缓存
修改检测周期后没效果	该参数需重启服务才生效