首页 > 代码库 > Wifidog的协议梳理

Wifidog的协议梳理

上篇文章结合wifidog的协议,讲解了如何实现wifi认证。这篇文章会详细讲解一下wifidog的协议。

wifidog的认证流程图

技术分享

  • 用户连接WIFI会跳转到以下地址:
1234567
http://auth_server/login?gw_id=[GatewayID, default: "default"]gw_address=[GatewayAddress, internal IP of router]gw_port=[GatewayPort, port that wifidog Gateway is listening on]url=[user requested url]auth_server #即认证的域名gw_id #配置的网关名称gw_address #回调的内网地址gw_port #回调的端口

在这个阶段需要返回登录的页面,即授权的首页,并且需要将所有涉及跳转的第三方地址加入白名单

  • 当验证用户身份之后,即用户登录成功之后重定向到网关地址
123
http://GatewayIP:GatewayPort/wifidog/auth?token=[auth token]auth token #系统为用户生成的token
  • 网关地址接受到消息后,会周期的发送用户信息,并确认是不是允许继续网络访问 请求地址
123456789101112131415161718192021
http://auth_server/auth/index.php?stage=countersip=mac=token=incoming=outgoing=ip,mac,token为用户的基本信息,incoming/outgoing为用户的连接计数信息,用来限定用户是否可以继续连接此时auth_server需要返回该请求:0——拒绝,删除防火墙内用户以及用户的信息6——用户验证失败,超时,会删除防火墙内信息(即会重新要求登录)1——用户验证通过,并跳转到http://auth_server/portal/?gw_id=%s5——用户需要验证,允许规则内的访问进行验证-1——用户验证出错,用户可以继续访问网络返回数据格式:Auth: <number from user status list>Auth: 1 #中间有个空格
  • 系统会周期性发送心跳包,用来确认网关验证和认证服务器的正常工作请求地址
123456789
http://auth_sever/ping/?gw_id=%ssys_uptime=%lusys_memfree=%usys_load=%.2fwifidog_uptime=%luauth_server此时需要返回“Pong可以通过该心跳包来监控整个认证的工作

相关资料:
认证流程图:http://dev.wifidog.org/wiki/doc/developer/FlowDiagram
认证的login协议: http://dev.wifidog.org/wiki/doc/developer/LoginProtocol
认证的客户端协议:http://dev.wifidog.org/wiki/doc/developer/ClientProtocol
认证过程中的心跳包协议:http://dev.wifidog.org/wiki/doc/developer/PingProtocol

Wifidog的协议梳理