WifiDog 是一款開(kāi)源的用來(lái)實(shí)現(xiàn)無(wú)線認(rèn)證的軟件，可以集成到路由器或者網(wǎng)關(guān)中，對(duì)于連接到路由器或者網(wǎng)關(guān)的設(shè)備，使其先登錄云端認(rèn)證服務(wù)器，然后通過(guò)認(rèn)證才能上網(wǎng)。比如在星巴克上網(wǎng)，瀏覽器會(huì)先彈出一個(gè)廣告頁(yè)面，我們輸入手機(jī)號(hào)，獲取驗(yàn)證碼，然后就可以上網(wǎng)了。

網(wǎng)關(guān)心跳（Ping協(xié)議）

Wifidog將ping協(xié)議做為心跳機(jī)制向認(rèn)證服務(wù)器發(fā)送當(dāng)前狀態(tài)信息。這可以實(shí)現(xiàn)為認(rèn)證服務(wù)器每個(gè)節(jié)點(diǎn)的狀態(tài)生成中央日志。

Wifidog客戶端在conf文件中進(jìn)行設(shè)置，目的是通過(guò)http定期啟動(dòng)thread(ping_thread.c)向認(rèn)證服務(wù)器發(fā)送狀態(tài)信息。信息格式如下：

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

通過(guò)系統(tǒng)調(diào)用wifidog客戶端收集的數(shù)據(jù)

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

一個(gè)標(biāo)準(zhǔn)的HTTP需求應(yīng)該是：

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

認(rèn)證服務(wù)器認(rèn)證協(xié)議

這個(gè)頁(yè)面描述了當(dāng)用戶已經(jīng)被認(rèn)證并允許訪問(wèn)互聯(lián)網(wǎng)時(shí)，為了認(rèn)證用戶和進(jìn)程，wifidog網(wǎng)關(guān)和認(rèn)證服務(wù)器之間的信息傳送。

Wifidog客戶端將定期的啟動(dòng)一個(gè)thread來(lái)報(bào)告每個(gè)用戶的連接狀況。目前它被用來(lái)報(bào)告每個(gè)用戶輸入/輸出計(jì)數(shù)器，以顯示用戶依然在現(xiàn)，并允許認(rèn)證服務(wù)器將不再連接的用戶斷開(kāi)。
以下是發(fā)給每個(gè)在線用戶的信息

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

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

新用戶狀態(tài)為：

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

注意：認(rèn)識(shí)服務(wù)器錯(cuò)誤一般不會(huì)改變防火墻或用戶狀態(tài)

標(biāo)準(zhǔn)的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

網(wǎng)關(guān)重定向?yàn)g覽器

客戶端瀏覽器在不同情況下會(huì)被重定向到其它頁(yè)面：

初始化請(qǐng)求：

基于捕捉，客戶端會(huì)被網(wǎng)關(guān)重定向到以下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

初始化請(qǐng)求之后

當(dāng)請(qǐng)求被處理并且客戶端已經(jīng)被重定向到網(wǎng)關(guān)時(shí)

如果服務(wù)器回復(fù)AUTH_DENIED：注意你通常在標(biāo)準(zhǔn)認(rèn)證服務(wù)器上看不到這樣的提示?？蛻舳藢⒉粫?huì)被重定向回網(wǎng)關(guān)。

gw_message.php?message=denied

如果服務(wù)器回復(fù)AUTH_VALIDATION:

gw_message.php?message=activate

如果服務(wù)器回復(fù)AUTH_ALLOWED:這是門戶重定向：

portal/?gw_id=%s

如果服務(wù)器回復(fù)AUTH_VALIDATION_FAILED:注意你將不會(huì)在標(biāo)準(zhǔn)認(rèn)證服務(wù)器看到此回復(fù)?？蛻舳藢⒉粫?huì)重定向回網(wǎng)關(guān)。

gw_message.php?message=failed_validation

認(rèn)證服務(wù)器重定向?yàn)g覽器

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

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