Jike-Box-wifidog-V2.0协议.doc

集客Widog V2.0Wifidog概述 wifidog是搭建无线热点认证系统的解决方案之一，他比nocat更适合互联网营销思路。目前支持openwrt系统，他实现了路由器和认证服 务器的数据交互，在路由器方是用C语言代码，通过wifidog程序和linux iptables防火墙实现接入用户的认证跳转和控制，在认证服务器方 是通过php实现用户的认证流程和管理。 优点：有开源代码，可以很方便的搭建认证系统。 缺点：标准协议是通过iptables方式实现，性能比较差，整体拉低了路由器的数据包处理速度，协议比较繁琐，对认证服务器的造成性能损耗比较大，在安全方面都是明文传输，有一定的安全隐患。 注：集客盒子wifidog在内核实现，已解决安全性和效率问题。认流流程： 以下配置为例：热点服务器地址为：热点服务器端口为: 80热点服务器路径为: /下列协议请求信息的蓝色部分参数为集客科技公司在兼容原生WIFIDOG协议的基础上为了根 据不同平台新增加的参数。认证平台搭建请参考搭建WIFIDOG认证平台.PDF一、网关心跳协议 Widog将ping协议作为心跳机制向认证服务器发送当前状态信息。实现认证服务器和每个节点的状态双向健康监测的机制。请求信息： gw_id=%s sys_load=%lu sys_memfree=%u sys_load=%.2f widog_uptime=%lu check_time 检查周期 gw_mac= 路由器mac地址 client_count= 连入路由器用户数 gw_address= 路由器网关地址 router_type= 路由器型号 wan_ip= wan口地址 sv 路由固件版本回复内容： Pong例子： GET /ping/?gw_id=1776&sys_uptime=1932&sys_memfree=36028&sys_load=0.07&widog_uptime=18&check_time=60&gw_mac=00:17:a5:e0:ca:34&wan_ip=192.168.81.22&clientcount=2&gw_address=192.168.8.1&router_ type=JIKE-BOX%20WP650&sv=4.2.35 HTTP/1.0 User-Agent:cnrouter widog Host: 二、用户状态上报协议请求格式： http:/auth_server/auth/? stage= 请求类型 ip= 客户端ip地址 mac= 客户端mac地址 token= 客户授权码 incoming= 下载速率 outgoing= 上传速率 gw_id= 路由器授权码 注意： ip，mac，token为用户的基本信息 incoming，outgoing为用户的连接计数信息。 stage为请求类别，值为 counter/ login/ logout，分别表示：已认证/新认证用户/超时删除的用户。回复内容： Auth: 状态码 (注意 中间冒号和状态码之间有个空格) 状态码为： 0 认证失败 1 认证成功例： GET /auth/?stage=counters&ip=7.0.0.107&mac=00:40:05:5F: 44:43&token=4f473ae3ddc5c1c2165f7a0973c57a98&incoming=6031353&out going=827770HTTP/1.0 User-Agent:cnrouter widog Host: 三、跳转协议 对于新连接用户，路由器将其产生的任意url请求通过302重定向到认证平台。请求格式： http:/auth_server/login/? gw_id= 热点账号 gw_address= 网关地址 gw_port= 网关端 mac= 客户端mac地址 url= 跳转前url gw_mac= 路由器mac地址例子： GET /login/? gw_id=808100949391&gw_address=192.168.81.1&gw_port=80&mac=aa:bb: cc:dd:cc:ee&url= HTTP/1.0 User-Agent:cnrouter widog Host: 四、用户注册协议 用户在平台申请注册，开通互联网权限。由平台将用户请求重定向到路由器， 完成注册。请求格式： http:/gw_ip/widog/auth? token=例子： GET widog/auth?token=12312412124 User-Agent:iphone Host:路由器ip 注册请求成功，以307的方式跳转平台的 portal/?gw_id=五、注册结果确认协议 认证流程走完，路由器会用307跳转方式，将用户请求重新跳转到认证平台。请求格式： http:/auth_server/portal/? gw_id= auth_result= 认证结果 auth_result 为 successed表示用户在路由器注册成功，failed表示用户在路由器注册失败。例子： GET /portal/? gw_id=808100949391&auth_result=successed HTTP/1.0 User-Agent:cnrouter widog Host: 六、在线升级协议 路由器请求平台进行自身升级。请求格式： http:/auth_server/upgrade/? sv= gw_mac= router_type=响应格式： upgrade:md5=cc5ce6c4f7147bbdb1babfc32a44338b#url=http:/ 192.168.81.55/static/nolimit_widog.trx#ver=4.1.1080 md5 为固件的md5值 url 为固件下载地址 Ver 为固件版本例子： GET /upgrade/? sv=4.1.1069&rmac=aa:bb:cc:dd:ee:ff&router_type=JIKE-BOX%20WP650 HTTP/1.0 User-Agent:cnrouter widog Host: auth_result 为 successed表示用户在路由器注册成功，failed表示用户在路由器注册失败。七、远程配置协议 路由器以热点运营里面的检查周期定时向平台发起配置请求，平台根据相关信 息对路由器进行配置和操作。请求格式： http:/auth_server/control/? action= Request gw_mac= 网关mac地址 ssid= 无线ssid gw_id= 热点账号 ver= 网关固件版本 wan_ip= 网关外网ip响应格式： 平台响应内容根据需求进行，为下列三类配置：格式： 任务序号；配置类型；配置项；具体参照例子平台响应内容根据需求进行，为下列三类配置：热点运营配置(widog)： ucode 热点账号 少于60字节 enable 启用认证 0 关闭 1 开启 Host 热点服务器地址 port 热点服务器端 req 热点服务器路径 Checktime 检查周期 Timeout 用户超时周期 whitemac 免认证mac名单 Whiteurl 免认证域名名单 apple 苹果支持 0 关闭 1 开启例子： task_id=10086;widog:enable=1;host=;timeout=1200; 无线配置（wi）： ssid 无线名称 例子： task_id=10087;wi:ssid=jike_10086 系统命令(system)： restart 重启 upgrade 升级 例子： task_id=10088;system:restart; 注意：所有控制命令都以分号;结尾。配置完成以后路由器向平台汇报配置任务状态，格式如下version 2.0 http:/auth_server/control/?action=reportgw_mac= 网关mac地址task_id= 任务序号gw_id= 热点账号ret= 0 完成 -1失败WIFI营销交流群：34287961