【产品教程】2026.07.10 XOS2.0（内部801）WIFI认证-光迅portal微信小程序认证部署（http）【认证部署】
操作背景：XOS2.0支持对接光迅portal服务器，实现手机连接wifi后，使用微信小程序认证上网，具体的部署和配置实现步骤如下：
案例环境如下图所示：
设备管理，对应vlan1，对应网段10.8.8.1/22，对应DHCP：10.8.9.2-10.8.11.254（不需要portal认证）
WIFI业务，对应vlan10，对应网段10.10.0.1/22，对应DHCP：10.10.1.2-10.10.3.254 （需要portal认证）
有线业务，对应vlan20，对应网段10.20.0.1/22，对应DHCP：10.20.1.2-10.20.3.254 （不需要portal认证）

![](/media/202607/cb002792a61b418681a046462ebe03698162.png)
1、XOS2.0设备版本需求和操作条件：
（1）XOS2.0设备的版本需求：C01V01R001P260416版本以上

![](/media/202607/41e8be7c830d4664848f141312cfce5d2865.png)
（2）操作前环境需要有通网条件
（3）部署微信小程序认证需要证书（最新的证书可以联系李老师获取，张工这边导入）

![](/media/202607/933c1d4a92034103a22836e9fb483b854058.png)
2、XOS2.0对接EAASportal微信小程序认证部署
第一部分：关键信息的获取
（1）项目名称和项目ID（EAAS上面自动生成的ID）

![](/media/202607/5fb997c4842d4275adf8d963f3a3787e9803.png)
（2）网关MAC（设备的LAN口mac，这里只是标识作用，因此，这里咱们统一用1口的mac）
网关mac的获取位置如下：

![](/media/202607/3b423ba3991a401da689bd8e72619aed4632.png)
（3）网关序列号（授权码通过一次MD5运算输出的结果）
网关序列号可以通过如下方式获取

![](/media/202607/7681149a35ae48f493681926b8b38b657302.png)
第二部分：光迅的portal服务器模块调试
第一步：登录portal服务器
portal服务器访问地址（外网地址）：http://wifiportal.sczhgx.com:8080/login
portal服务器访问地址（内网地址）：http://10.8.9.99:9535/login
登录账号：admin
登录密码：aA@123456..

![](/media/202607/8438ad192a6b42b6bd4b35d23f2e4ed03941.png)
登录完成后，portal平台的主页情况如下：

![](/media/202607/ab5d9bb6d88c45d7a31a8af687b7c6005197.png)
第二步：创建小程序对接模板（客户没有单独做小程序开发的话默认直接使用咱们的小程序，该情况下此步骤可以省略！！！）
注意：这里有客户自己的小程序的时候，才需要额外创建；客户没有自己的小程序的时候，可以直接调用咱们的小程序，那么，这一步则跳过
注意：若客户某个项目需要使用自己的小程序，配置名称的命名规范为：<项目名称>认证小程序-项目ID

![](/media/202607/79d61442fa7846eaaae2f64364b838ce8753.png)
填写关键参数：
（1）小程序AppID：wx41**********a2744e9b
（2）小程序版本：正式版 release

![](/media/202607/a6fc6f35e60a46f9b65189879a9f2ba53512.png)
（3）App Secret：75e3cfce27d************e37fa3b65b0c
（4）跳转页面路径：pages/portal/index

![](/media/202607/d2c246c020294c2b9815741f9c24d0669118.png)
第三步：创建认证配置模板，认证配置模板调用对接模板

![](/media/202607/69ca26498fb44446affd548322b334969460.png)

![](/media/202607/917e80ed5309448b967a41e6280a78fa9811.png)

![](/media/202607/720efcbd2c114ac886ade6347bd480805988.png)

![](/media/202607/fe225c5035664cb4a1b9d5eee64140217863.png)
配置完成后，点击保存配置
第四步：配置门店，调用绑定认证配置模板

![](/media/202607/a23cab26cbf34e5492803fea7073b5975245.png)

![](/media/202607/902f8349f97a4870bf786dad688375407590.png)
第三部分：XOS2.0设备的调试（基础网络参数）
第一步：配置物理接口属性

![](/media/202607/8300e9328e83438685353bf91856e2b89154.png)
第二步：配置LAN口（GE0-2接口）配置IP：10.10.0.1/22

![](/media/202607/70acaf7812874f7f980a0b38a7b3704f8538.png)
第三步：配置WAN口（GE0-1接口）配置IP：（对应外网的接入方式）

![](/media/202607/33228597cfe04d5da4db3a46f103a1425683.png)
第四步，配置缺省路由（缺省路由指向对应出接口网关IP地址）

![](/media/202607/33f473a5f7c9456ab1512d0b27d1c2a45913.png)

![](/media/202607/949b7482992a48e1b380ffa221207aca5827.png)
第五步，配置NAT规则

![](/media/202607/df10a47db1404a45a804a4457a1661d41297.png)

![](/media/202607/6679c6a43b9147caab4b7782b9c91fb51907.png)
第六步：配置安全策略（这里咱们是任意区域之间的互通）

![](/media/202607/42aad0045b944714aaa1787b4f0e8bd37153.png)
第四部分：配置portal认证
第一步：在LAN口配置中打开web认证开关

![](/media/202607/2aed7cd9421342348393747c2b7ae7b65129.png)

![](/media/202607/d41dfc3f9b7940f9aabaa76b88ea0fb02207.png)

第二步：添加认证策略，认证类型设置为wifidog

![](/media/202607/f6fba3f1401f40e5b6b7aab3229da6722044.png)
默认是没有认证条目的，咱们点击新增，点击后可新增认证条目
特别注意：portal场景下，自动绑定这里不要配置，因为portal场景下，终端基本上都是移动的手机，这里我们不需要做IP地址绑定鉴权！
特别注意：portal场景下，咱们一般选择绑定mac地址（在portal场景下系统在加入组织的过程中，会将mac作为用户名，将用户加入到组织中）
特别注意：一定不能去绑定IP地址，绑定IP地址的意思是只允许用户使用这个IP地址上网，不是这个IP地址不允许上网

![](/media/202607/751ffbd103cc424aa276da430d58fa8f6555.png)
配置完成后，点击确定提交，在认证策略条目中，可以看到咱们刚刚添加的条目

![](/media/202607/b023b31416a7498f95a5234a9bad29471358.png)
第三步：配置认证参数
注意：目前小程序已经可选择走http的方式
注意：认证端口必须要填写806端口，否则会端口冲突

![](/media/202607/10122d9b3bd34e729d178d5f7db8efc28506.png)
第四步：新增域名组（第五步调用）
咱们新增域名组
portal域名组：portal过程中，终端请求登录页和成功页等，和云端portal服务器交互使用的域名
wifiportal.sczhgx.com（M1产品线）；
OSS域名组：在登录页成功页中，一些图片素材（比如背景图片，logo等等）资源的请求地址使用的域名
wifi-portal.oss-cn-shenzhen.aliyuncs.com（以后使用）；
at-portal-test.oss-cn-hangzhou.aliyuncs.com（当前使用）；

![](/media/202607/e000543743e64f34af0388ab6f5fc8df8819.png)
创建portal域名组（只需要填写 wifiportal.sczhgx.com（M1产品线）即可）

![](/media/202607/48f3bd23d2b440f481c6313251006e9e2287.png)
创建OSS域名组

![](/media/202607/76d8c504ca754563bd28469e89173ec87119.png)
创建好后，情况如下图：

![](/media/202607/74d5be933a6f49459541501cd0cb86cb6145.png)
第五步：配置未认证权限
新增未认证权限项，确保网关设备不会拦截：
Portal域名：wifiportal.sczhgx.com
OSS域名：
wifi-portal.oss-cn-shenzhen.aliyuncs.com（以后使用）；at-portal-test.oss-cn-hangzhou.aliyuncs.com（当前使用）；

![](/media/202607/c61a2bc7f26d4a3998dd26b3f19a035f5289.png)
创建Portal域名放行

![](/media/202607/5ad3ccd7eecf4a6b9e047ce73d1525a91805.png)
创建
OSS域名放行

![](/media/202607/8aacf601869a4cebb4508b2ae62975582204.png)
添加完成后，如下图所示：（可以看到未认证选项这里调用了刚刚上一步创建的域名组，确保网关设备不会拦截portal服务器地址：wifiportal.sczhgx.com）

![](/media/202607/82b8d5b8c6724e6c96acd586a8ceb8983147.png)

第六步：配置wifidog服务器
配置portal服务器地址为：https://wifiportal.sczhgx.com/gxwifidog

![](/media/202607/5c58c1c942b8453f8ba4aba61e5c63642137.png)

![](/media/202607/5cd24a4cff8541f29875aea0c7ab3e225193.png)

梦想网关 路由模式对接光迅portal微信小程序认证部署(http)【认证部署】

梦想网关路由模式对接光迅portal微信小程序认证部署(http)【认证部署】