wifidog 接口详解

wifidog.pro

概述
wifidog：是搭建无线热点认证系统的解决方案之一，他比nocat更适合互联网营销思路。目前支持openwrt系统，他实现了路由器和认证服务器的数据交互，在路由器方是用C语言代码，通过wifidog程序和linux iptables防火墙实现接入用户的认证跳转和控制，在认证服务器方是通过php实现用户的认证流程和管理。

0 b9 m  _$ i% A/ `! i" O5 f优点：有开源代码，可以很方便的搭建认证系统。
缺点：通过iptables方式实现，性能比较差，整体拉低了路由器的数据包处理速度，协议比较繁琐，对认证服务器的造成性能损耗比较大，在安全方面都是明文传输，有一定的安全隐患。

认证流程
注意：
热点服务器地址为：auth_server
热点服务器路径为:   /

. f4 Y# n% u% \" d网关心跳协议
Wifidog将ping协议作为心跳机制向认证服务器发送当前状态信息。实现认证服务器和每个节点的状态双向健康监测的机制。
& w' Q& L0 t7 s: O% E- j请求信息：
http://auth_sever/ping/?
" Q$ R: o8 D3 P  k  G* Fgw_id=%s
sys_load=%lu
/ L& [1 `8 T: c, E8 H% O$ B' tsys_memfree=%u
sys_load=%.2f
wifidog_uptime=%lu
! V' o# Q2 e% u* R* ]回复格式：Pong
& G1 R& u7 r" X# C9 {) \; {- U5 Z: p, R例子：
3 O- {; q! y( _( H7 v7 \# HGET /ping/?                                                       gw_id=001217DA42D2&sys_uptime=742725&sys_memfree=2604&sys_load=0.03&wifidog_uptime=3861 HTTP/1.0
0 h- O0 R& S  L0 |# y. b8 zUser-Agent:cnrouter wifidog
Host: auth.cnrouter.com
* Z0 I. M! b) o  t/ O
0 Q/ x) M& v7 R6 `5 O) h! A1 ^用户状态心跳协议
3 f  @7 [# f4 `) X请求格式：
http://auth_server/auth/?    (因文明发贴将：换为&)
9 G5 V% j( ~3 b$ f1 p% }stage=
ip=
mac=
, ]1 x3 ]8 L  Wtoken=
incoming=
) N, a( ^' O" n2 Z, Zoutgoing=

: m3 C, [. w. r- T; e3 A注意：
ip,mac,token为用户的基本信息，incoming/outgoing为用户的连接计数信息。
0 d/ B7 H  ~. a& c- w/ `4 fstage=counter|login|logout，分别表示：已认证，新认证用户，超时需要删除的用户。
" A- Z& B2 g9 T% s; w" H$ _回复格式：
8 Z! K; K5 M  Z/ h" `) gAuth: 状态码   (注意 中间冒号和状态码之间有个空格)
' m8 H  q( v, ?1 Y; @. P! e状态码：
0 - AUTH_DENIED - User firewall users are deleted and the user removed.
1 - AUTH_ALLOWED - User was valid, add firewall rules if not present
  [% L$ ~/ X" U5 I/ W' c9 E0 ^/ x例子：
GET /auth/?stage=counters&ip=7.0.0.107&mac=00:40:05:5F:44:43&token=4f473ae3ddc5c1c2165f7a0973c57a98&incoming=6031353&outgoing=827770 HTTP/1.0
User-Agent:cnrouter wifidog
& u- O3 H0 ~: uHost: auth.cnrouter.com
& \  q2 Z3 b1 I- R8 `8 h+ m
跳转协议
; I* G  p6 r2 _9 \对于新连接用户，路由器将其产生的任意url请求通过302重定向到认证平台.
9 Y$ C. P! W" X. ]请求格式：
http&//auth_server/login/?   (因文明发贴将:换为&)
) ~" A& ^8 N' Ggw_id=
* [% c9 m+ _  {9 s8 n7 [gw_address=
* b7 b  p! C6 ]2 r/ ~9 Agw_port=
# J* w8 ?& ?; t+ ymac=
# X3 ?6 s. I8 `3 r4 e- L  M- b* xurl=
0 S: f7 H0 @8 i; z/ s例子：
GET /login/?gw_id=808100949391&gw_address=192.168.81.1&gw_port=80&mac=aa:bb:cc:dd:cc:ee&url=http&//www.sina.com.cn/ HTTP/1.0
User-Agent:cnrouter wifidog
; p. G8 G' |" rHost: auth.cnrouter.com

注册协议
平台确定成功注册用户，开通互联网权限，将用户请求重定向到路由器，完成注册。
请求格式：
http://gw_ip/wifidog/auth?
, u/ \, {  b3 b* ]/ Y. ~' xtoken=
例子：
% D8 U6 s7 K2 l9 i: _' C* z0 K9 bGET wifidog/auth?token=12312412124
User-Agent:iphone
Host:路由器ip
注册请求成功，以307的方式跳转平台的 portal/?gw_id=
1 O! v. k1 H9 [  l  K
: `% d" e' v; h1 S$ b, K引用自：www.wifidog.pro
0 I0 K; t! E: O

! R  o  |) s4 v' Y; {8 G