日期 | 版本号 | 修订说明 | 修订人 |
2016-04-08 | V1.00 | 新建文档 | 熊远雄 |
2016-04-13 | V1.02 | 修改登陆和心跳,添加工作流程 | 熊远雄 |
| | | |
| | | |
| | | |
| | | |
目录
广东电信aWiFi平台接口规范 1
第1章前言 1
1.1 aWiFi系统概述 1
1.2 网络架构 2
2.1 概述 4
2.3 保活和下线 7
第3章 aWiFi平台云AC接口规范 10
3.1 概述 10
3.2 连接登陆云AC 11
3.3 心跳与断开重连机制 12
3.4 执行配置管理 13
3.4.1 测试连接 13
3.4.2 设置SSID 14
3.4.3 重启 14
3.4.4 远程升级 14
第1章 5d动感座椅前言
本标准是广东电信aWiFi终端系列企业标准之一，该系列标准目前包括： 1) 广东电信aWiFi终端规范--技术指标；
无尘涂装
2) 广东电信aWiFi终端技术要求--xxx
3) 广东电信aWiFi平台接口规范；
4) 广东电信aWiFi安全审计平台接口规范
本文描述aWiFi系统中，aWiFi终端设备与aWiFi平台的通信协议流程，包括aWiFi终端设备与aWiFi平台认证服务的接口，aWiFi终端设备与aWiFi平台云AC通信的接口。
1.1 aWiFi系统概述
广东电信aWiFi系统由WiFi用户（手机，平板电脑等）、WiFi网络接入设备、aWiFi管理平台和BOSS系统组成。WiFi网络接入设备分为两类，一类是集中控制型（AC+瘦AP）设备，一类是aWiFi终端。aWiFi管理平台内部又可分为两部分：云AC平台和认证服务平台。分别负责aWiFi终端设备管理和广告推送服务。为客户提供aWiFi业务。
aWiFi系统总体参考模型如图1所示。
图１：aWiFi系统模型
aWiFi系统模型说明如下：
1) aWiFi终端
aWiFi终端包括单AP终端，融合终端和一体终端，aWiFi终端与aWiFi平台之间使用统一的接口规范，aWiFi终端的相关技术指标和接口在本系列规范中说明。
2) 参考点Mg
参考点Mg是aWiFi管理平台和aWiFi终端之间的接口界面，包括终端设备管理和认证服务两部分，实现aWiFi终端认证和业务配置管理。该接口界面将在本文中说明。
3) 参考点Mc
参考点Mc是aWiFi管理平台和AC+AP型WiFi网络接入设备之间的接口界面，实现WiFi终端认证和业务配置管理。
1.2 网络架构
aWiFi系统的网络架构如下图所示：
aWiFi业务平台网络架构如下图所示
第2章 aWiFi平台认证接口规范
半有源rfid2.1 概述
aWiFi终端和aWiFi平台认证服务的通信协议是基于wifidog_protocol_V1（/wiki/doc/developer/WiFiDogProtocol_V1），并作出了部分细节的修改，其中主要增加了用户的预鉴权流程，实现免登陆认证功能，建议aWiFi终端厂商使用开源软件包wifdog V1.3.0进行开发实现。
为方便，本文直接用wifidog来代指在aWiFi终端中实现与认证平台通信的程序。
aWiFi认证平台的信息如下：
aWiFi认证平台主机(%SERVER) | aWiFi认证平台端口(%PORT) |
| 8001 |
| |
2.2 WiFi用户上线
WiFi用户上线流程如下图所示：
1. 首先aWiFi终端通过iptables更改防火墙，将未认证的用户dnat到wifidog进程，当WiFi用户接入终端后访问外网时，wifidog首先拦截其http报文，然后询问aWiFi认证平台该用户是否准入，对应上图中的流程②，请求实例如下： [GET /smartwifi/auth/?stage=preauth&ip=192.168.1.239&mac=3c:97:0e:d2:f6:67&token=bcabec2922484678d913cf512fee6738&incoming=0&outgoing=0&gw_id=D4EE07083302
HTTP/1.0
User-Agent: WiFiDog 20150427
Host: ]
报文以GET方法访问aWiFi认证平台的auth路径，其中参数stage=preauth表示当前为预鉴权阶段，ip为用户ip，mac为用户MAC，token为用户MAC的md5值，gw_id为aWiFi终端的MAC。
2. 对于新用户，aWiFi认证平台将返回鉴权失败的200报文，对应上图中的流程③，如下所示：
[HTTP/1.1 200 OK
Connection: close
Date: Mon, 31 Aug 2015 11:30:28 GMT
Content-Length: 7
X-Powered-By: Servlet/2.5 JSP/2.1
Auth: 0]
当aWiFi认证平台返回Auth：1则表示鉴权成功，wifidog随即放通用户，并把当前web请求重定向回原先访问页面，实现免登陆认证的接入上网；当aWiFi认证平台返回Auth：0则表示需要该用户鉴权失败，需要登陆认证才能上网，此时wifidog则通过307报文将用户重定向到aWiFi认证平台的认证页面，对应上图中的流程⑤。重定向请求实例如下：
[GET
/
smartwifi/login/?gw_address=192.168.1.1&gw_port=2060&gw_id=D4EE07083302&mac=3c:97:0e:d2:f6:67&url=http%3A//api./rgeoc/%3Flnglat%3D113.182954%2C23.105509%26referer%3Dpcqq_client
HTTP/1.0
User-Agent: WiFiDog 20150427
Host: ]
报文以GET方法访问aWiFi认证平台的login路径，表示当前已经进入认证阶段，gw_address为aWiFi终端本地网关ip，gw_port设定为2060，mac为用户MAC，gw_id为aWiFi终端的MAC，url为用户原本希望访问的页面链接。
3. WiFi用户在登录页面，输入用户名密码，发送认证请求。
4. 认证成功的话aWiFi认证平台发送302报文，携带token信息重定向到wifidog页面。认证失败的话返回失败页面。
5. 用户携带token信息向wifidog发起认证请求，wifidog再向aWiFi认证平台发起请求，对应
玉米割晒机上图中的流程来电显示电话机⑪，请求实例如下：
[GET /smartwifi/auth/?stage=login&ip=192.168.1.239&mac=3c:97:0e:d2:f6:67&token=bcabec2922484678d913cf512fee6738&incoming=0&outgoing=0&gw_id=D4EE07083302
HTTP/1.0
User-Agent: WiFiDog 20150427
Host: ]
报文以GET方法访问aWiFi认证平台的auth路径，其中参数stage=login表示当前为登录鉴权阶段，ip为用户ip，mac为用户MAC，token为用户MAC的md5值，gw_id为aWiFi终端的MAC。
6. 认证成功后授权，aWiFi认证平台返回200包给wifidog，对应上图中的流程⑫，如下所示：
[HTTP/1.1 200 OK
Connection: close
Date: Tue, 01 Sep 2015 06:40:44 GMT
Content-Length: 7
X-Powered-By: Servlet/2.5 JSP/2.1
Auth: 1]
7. wifidog检测到Auth: 1，用307报文将用户重定向到成功登录页面，对应上图中的流程⑬，如下所示。
[GET
/smartwifi/portal/?gw_id=D4EE07083302
HTTP/1.0
User-Agent: WiFiDog 20150427
Host: ]
报文以GET方法访问aWiFi认证平台的portal路径，其中参数gw_id为aWiFi终端的MAC。aWiFi认证平台根据此参数推送对应商家的成功页面。
2.3 保活和下线
1. aWiFi终端会定时向aWiFi认证平台发送保活消息。保活消息包括aWiFi终端自身保活和接入aWiFi终端的所有WiFi用户设备保活两部分。
2. 其中aWiFi终端自身保活是指aWiFi终端和aWiFi认证平台链路检查。如下图所示：
请求实例如下所示：
[GET /smartwifi/ping/?gw_id=D4EE07083302&sys_uptime=7977811&sys_memfree=86908&sys_load=0.00&wifidog_uptime=362 HTTP/1.0
User-Agent: WiFiDog 20150427气泡包装膜
Host: ]
报文以GET方法访问aWiFi认证平台的ping路径，其中参数gw_id为aWiFi终端的MAC。随后几项参数包含aWiFi终端及wifidog进程相关健康状况信息。收到aWiFi终端发出的ping请求后，aWiFi认证平台用200包的文本Pong来回应，如下所示：
