WifiDog 是一款開源的用來實現無線認證的軟件，可以集成到路由器或者網關中，對于連接到路由器或者網關的設備，使其先登錄云端認證服務器，然后通過認證才能上網。比如在星巴克上網，瀏覽器會先彈出一個廣告頁面，我們輸入手機號，獲取驗證碼，然后就可以上網了。

網關心跳（Ping協議）

Wifidog將ping協議做為心跳機制向認證服務器發送當前狀態信息。這可以實現為認證服務器每個節點的狀態生成中央日志。

Wifidog客戶端在conf文件中進行設置，目的是通過http定期啟動thread(ping_thread.c)向認證服務器發送狀態信息。信息格式如下：

http://auth_sever/ping/?????
gw_id=%s
sys_uptime=%lu????
sys_memfree=%u????
sys_load=%.2f????
wifidog_uptime=%lu

通過系統調用wifidog客戶端收集的數據

Headers
HTTP/1.0\r\n"?
"User-Agent:?WiFiDog?%s\r\n"?
"Host:?%s\r\n"?
"\r\n",

一個標準的HTTP需求應該是：

GET?/ping/?gw_id=001217DA42D2&sys_uptime=742725&sys_memfree=2604&sys_load=0.03&wifidog_uptime=3861?HTTP/1.0
User-Agent:?WiFiDog?1.1.3_beta6
Host:?wifidog.pro

認證服務器認證協議

這個頁面描述了當用戶已經被認證并允許訪問互聯網時，為了認證用戶和進程，wifidog網關和認證服務器之間的信息傳送。

Wifidog客戶端將定期的啟動一個thread來報告每個用戶的連接狀況。目前它被用來報告每個用戶輸入/輸出計數器，以顯示用戶依然在現，并允許認證服務器將不再連接的用戶斷開。
以下是發給每個在線用戶的信息

auth_server:/auth/index.php?
stage=
ip=
mac=
token=
incoming=
outgoing=

注意：stage=計數器/登錄，取決于是否是新客戶端
即使輸入輸出變量會在所有信息中出現，但他們只對處于counter階段的信息有效。其它情況下輸入輸出經常設置為0。
在做回復時，認證服務器會以有效身份或新用戶信息，或者認證服務器錯誤提示形式進行回復。
回復格式如下：
Auth:

新用戶狀態為：

0?-?AUTH_DENIED?-?User?firewall?users?are?deleted?and?the?user?removed.
6?-?AUTH_VALIDATION_FAILED?-?User?email?validation?timeout?has?occured?and?user/firewall?is?deleted
1?-?AUTH_ALLOWED?-?User?was?valid,?add?firewall?rules?if?not?present
5?-?AUTH_VALIDATION?-?Permit?user?access?to?email?to?get?validation?email?under?default?rules
-1?-?AUTH_ERROR?-?An?error?occurred?during?the?validation?process

注意：認識服務器錯誤一般不會改變防火墻或用戶狀態

標準的URL為：

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:?WiFiDog?1.1.3_beta6
Host:?wifidog.pro

網關重定向瀏覽器

客戶端瀏覽器在不同情況下會被重定向到其它頁面：

初始化請求：

基于捕捉，客戶端會被網關重定向到以下URL：

login/?gw_address=%s&gw_port=%d&gw_id=%s&url=%s?
例如：https://wifidog.pro/login/?gw_id=0016B6DA9AE0&gw_address=7.0.0.1&gw_port=2060

初始化請求之后

當請求被處理并且客戶端已經被重定向到網關時

如果服務器回復AUTH_DENIED：注意你通常在標準認證服務器上看不到這樣的提示。客戶端將不會被重定向回網關。

gw_message.php?message=denied

如果服務器回復AUTH_VALIDATION:

gw_message.php?message=activate

如果服務器回復AUTH_ALLOWED:這是門戶重定向：

portal/?gw_id=%s

如果服務器回復AUTH_VALIDATION_FAILED:注意你將不會在標準認證服務器看到此回復。客戶端將不會重定向回網關。

gw_message.php?message=failed_validation

認證服務器重定向瀏覽器

基于成功登錄，客戶端將被重定向到網關。 http://" . $gw_address . ":" . $gw_port . "/wifidog/auth?token=" . $token

URL示例：http://192.168.1.1:2060/wifidog/auth?token=4f473ae3ddc5c1c2165f7a0973c57a98