wifidog 源碼初分析（4）－轉

在上一篇《wifidog 源碼處分析(3)》的流程結束后，接入設備的瀏覽器重定向至 路由器 上 wifidog 的 http 服務（端口 2060） /wifidog/auth 上（且攜帶了 認證服務器 為此接入設備分配的 token），本篇就是從 wifidog 接收到 /wifidog/auth 的訪問后的 校驗流程。

-

根據《wifidog 源碼初分析(2)》中描述的，在 wifidog 啟動 http 服務前，注冊了一個針對訪問路徑 /wifidog/auth 的回調，如下：

[cpp] view plaincopy

1. httpdAddCContent(webserver, "/wifidog", "about", 0, NULL, http_callback_about);  
2. httpdAddCContent(webserver, "/wifidog", "status", 0, NULL, http_callback_status);  
3. // 注冊了針對 /wifidog/auth 的訪問回調 http_callback_auth
4. httpdAddCContent(webserver, "/wifidog", "auth", 0, NULL, http_callback_auth); 

這樣對於 接入設備(or 客戶端) 重定向過來的 /wifidog/auth 就進入了 http_callback_auth 函數中，如下：

[cpp] view plaincopy

1. http_callback_auth(httpd *webserver, request *r)  
2. {  
3.     t_client    *client;  
4.     httpVar * token;  
5. char    *mac;  
6. // 1, 獲取條件參數中的 logout 值
7.     httpVar *logout = httpdGetVariableByName(r, "logout");  
9. // 2, 獲取條件參數中的 token 值
10. if ((token = httpdGetVariableByName(r, "token"))) {  
11. /* They supplied variable "token" */
12. // 3, 可以看到, 這里要求必須能夠通過 ARP 協議獲取到 接入設備 的 MAC 地址
13. if (!(mac = arp_get(r->clientAddr))) {  
14. /* We could not get their MAC address */
15.             debug(LOG_ERR, "Failed to retrieve MAC address for ip %s", r->clientAddr);  
16.             send_http_page(r, "WiFiDog Error", "Failed to retrieve your MAC address");  
17.         } else {  
18. /* We have their MAC address */
19.             LOCK_CLIENT_LIST();  
20. // 4, 檢查該客戶端(接入設備)是否已經在 wifidog 維護的接入客戶端列表中
21. if ((client = client_list_find(r->clientAddr, mac)) == NULL) {  
22.                 debug(LOG_DEBUG, "New client for %s", r->clientAddr);  
23.                 client_list_append(r->clientAddr, mac, token->value);  
24.             } else if (logout) {  
25. // 5, 退出處理
26.                 t_authresponse  authresponse;  
27.                 s_config *config = config_get_config();  
28.                 unsigned long long incoming = client->counters.incoming;  
29.                 unsigned long long outgoing = client->counters.outgoing;  
30. char *ip = safe_strdup(client->ip);  
31. char *urlFragment = NULL;  
32.                 t_auth_serv *auth_server = get_auth_server();  
34.                 fw_deny(client->ip, client->mac, client->fw_connection_state);  
35.                 client_list_delete(client);  
36.                 debug(LOG_DEBUG, "Got logout from %s", client->ip);  
38. /* Advertise the logout if we have an auth server */
39. if (config->auth_servers != NULL) {  
40.                     UNLOCK_CLIENT_LIST();  
41.                     auth_server_request(&authresponse, REQUEST_TYPE_LOGOUT, ip, mac, token->value,  
42.                                         incoming, outgoing);  
43.                     LOCK_CLIENT_LIST();  
45. /* Re-direct them to auth server */
46.                     debug(LOG_INFO, "Got manual logout from client ip %s, mac %s, token %s"
47. "- redirecting them to logout message", client->ip, client->mac, client->token);  
48.                     safe_asprintf(&urlFragment, "%smessage=%s",  
49.                         auth_server->authserv_msg_script_path_fragment,  
50.                         GATEWAY_MESSAGE_ACCOUNT_LOGGED_OUT  
51.                     );  
52.                     http_send_redirect_to_auth(r, urlFragment, "Redirect to logout message");  
53.                     free(urlFragment);  
54.                 }  
55.                 free(ip);  
56.             }  
57. else {  
58. // 6, 已經登錄校驗通過
59.                 debug(LOG_DEBUG, "Client for %s is already in the client list", client->ip);  
60.             }  
61.             UNLOCK_CLIENT_LIST();  
62. if (!logout) {  
63. // 7, 到 auth server 上進一步校驗 token
64.                 authenticate_client(r);  
65.             }  
66.             free(mac);  
67.         }  
68.     } else {  
69. /* They did not supply variable "token" */
70. // 8, 未攜帶 token, 直接拒絕
71.         send_http_page(r, "WiFiDog error", "Invalid token");  
72.     }  
73. } 

在該函數中主要處理了 客戶端退出，非法校驗，以及 客戶端校驗等流程，下面分別描述注釋中的各個步驟：

-

1，對於客戶端退出，則會攜帶 logout 參數信息，並走到第 5 步（當然，如果連 token 參數都沒有的話，會直接走到第 8 步，也就是拒絕）；

2，按照正常的認證流程，會攜帶由認證服務器分配的 token 參數；

3，正如注釋說明的，這里要求必須能夠通過 ARP 協議獲取到 接入設備 的 MAC 地址；（其實通過查看 arg_get 的實現，可以看到是直接解析 /proc/net/arp 文件 -- ARP cache -- 來獲取對應客戶端 IP 地址的 MAC 信息的），類似如下：

[steven@sasd ~]$ more /proc/net/arp

IP address       HW type     Flags       HW address            Mask     Device

192.168.1.203    0x1         0x2         18:03:73:d5:1b:a2     *        eth0

192.168.1.1      0x1         0x2         00:21:27:63:c0:ce     *        eth0

[steven@sasd ~]$

4，在能夠獲取到該客戶端的 MAC 地址后，根據客戶端的 IP 和 MAC 地址檢查該客戶端是否已經在 wifidog 維護的接入設備（or客戶端）列表中，如果不在，則追加到此列表中（關於此列表的數據結構在后面再詳細描述）；

5，如果該客戶端已經存在，且本次訪問是要求 logout 退出的，則進入此退出處理的流程，該流程主要包括幾個步驟：關閉該客戶端 ip/mac 的出口（outgoing）規則 --> 從客戶端列表中刪除該客戶端記錄 --> 通知 認證服務器 該客戶端退出（且攜帶該客戶端的token， 上下行流量等信息） --> 返回重定向至 認證服務器 的 #define DEFAULT_AUTHSERVMSGPATHFRAGMENT "gw_message.php?" 訪問路徑（攜帶一個已退出的 message）；

6，如果該客戶端已經登錄校驗過，且本次訪問非 logout 退出，則直接跳轉到第 7 步；

7，這一步就是 token 校驗的過程，具體實現在 authenticate_client 函數中：

[cpp] view plaincopy

1. authenticate_client(request *r)  
2. {  
3.     t_client    *client;  
4.     t_authresponse  auth_response;  
5. char    *mac,  
6.         *token;  
7. char *urlFragment = NULL;  
8.     s_config    *config = NULL;  
9.     t_auth_serv *auth_server = NULL;  
10.     LOCK_CLIENT_LIST();  
11. // 根據 IP 地址獲取 客戶端的 MAC 地址以及本次會話分配的 token
12. // 主要用於 token 校驗過程
13.     client = client_list_find_by_ip(r->clientAddr);  
14. if (client == NULL) {  
15.         debug(LOG_ERR, "authenticate_client(): Could not find client for %s", r->clientAddr);  
16.         UNLOCK_CLIENT_LIST();  
17. return;  
18.     }  
20.     mac = safe_strdup(client->mac);  
21.     token = safe_strdup(client->token);  
23.     UNLOCK_CLIENT_LIST();  
25. /*
26.      * At this point we've released the lock while we do an HTTP request since it could
27.      * take multiple seconds to do and the gateway would effectively be frozen if we
28.      * kept the lock.
29.      */
30. // 通過 "login" 到 認證服務器 上進行客戶端的 token 校驗
31.     auth_server_request(&auth_response, REQUEST_TYPE_LOGIN, r->clientAddr, mac, token, 0, 0);  
33.     LOCK_CLIENT_LIST();  
35. /* can't trust the client to still exist after n seconds have passed */
36. // 這里主要防止在到 認證服務器 上進行 token 校驗的過程中
37. // 該客戶端已經退出的情形, 此時就不需要再進行處理
38.     client = client_list_find(r->clientAddr, mac);  
39. if (client == NULL) {  
40.         debug(LOG_ERR, "authenticate_client(): Could not find client node for %s (%s)", r->clientAddr, mac);  
41.         UNLOCK_CLIENT_LIST();  
42.         free(token);  
43.         free(mac);  
44. return;  
45.     }  
47.     free(token);  
48.     free(mac);  
49. /* Prepare some variables we'll need below */
50.     config = config_get_config();  
51.     auth_server = get_auth_server();  
52. // 根據返回的校驗結果做不同的處理
53. switch(auth_response.authcode) {  
54. case AUTH_ERROR:  
55. case AUTH_DENIED:  
56. case AUTH_VALIDATION:  
57. case AUTH_VALIDATION_FAILED:  
58.         ... ...  
59. break;  
60. case AUTH_ALLOWED:  
61. /* Logged in successfully as a regular account */
62.         debug(LOG_INFO, "Got ALLOWED from central server authenticating token %s from %s at %s - "
63. "adding to firewall and redirecting them to portal", client->token, client->ip, client->mac);  
64.         client->fw_connection_state = FW_MARK_KNOWN;  
65.         fw_allow(client->ip, client->mac, FW_MARK_KNOWN);  
66.         served_this_session++;  
67.         safe_asprintf(&urlFragment, "%sgw_id=%s",  
68.             auth_server->authserv_portal_script_path_fragment,  
69.             config->gw_id  
70.         );  
71.         http_send_redirect_to_auth(r, urlFragment, "Redirect to portal");  
72.         free(urlFragment);  
73. break;  
74.     }  
75.     UNLOCK_CLIENT_LIST();  
76. return;  
77. } 

這里主要是兩大步驟：

-

1，通過調用 auth_server_request(&auth_response, REQUEST_TYPE_LOGIN, r->clientAddr, mac, token, 0, 0); 讓 認證服務器 對該客戶端的 token 進行校驗；

2，根據 認證服務器 返回的 token 校驗結果進行不同的處理（主要是對該客戶端的防火牆過濾規則進行不同的設置），這里主要以 AUTH_ALLOWED 校驗結果進行分析，這里主要是兩個動作：

2.1，通過 fw_allow 函數調用對此客戶端"放行"；

2.2，返回重定向至 認證服務器的 portal 路徑訪問的響應；

-

這里就簡要分析一下 fw_allow 函數的實現，查看fw_allow的實現可以看到真正設置allow客戶端通過防火牆的動作是在iptables_fw_access中實現的，如下：

[cpp] view plaincopy

1. /** Set if a specific client has access through the firewall */
2. // 針對上面的流程，這里的輸入參數
3. // type 為 FW_ACCESS_ALLOW，tag 為 FW_MARK_KNOWN
4. int iptables_fw_access(fw_access_t type, const char *ip, const char *mac, int tag)  
5. {  
6. int rc;  
7.     fw_quiet = 0;  
8. switch(type) {  
9. case FW_ACCESS_ALLOW:  
10.             iptables_do_command("-t mangle -A " TABLE_WIFIDOG_OUTGOING " -s %s -m mac --mac-source %s -j MARK --set-mark %d", ip, mac, tag);  
11.             rc = iptables_do_command("-t mangle -A " TABLE_WIFIDOG_INCOMING " -d %s -j ACCEPT", ip);  
12. break;  
13. case FW_ACCESS_DENY:  
14.             iptables_do_command("-t mangle -D " TABLE_WIFIDOG_OUTGOING " -s %s -m mac --mac-source %s -j MARK --set-mark %d", ip, mac, tag);  
15.             rc = iptables_do_command("-t mangle -D " TABLE_WIFIDOG_INCOMING " -d %s -j ACCEPT", ip);  
16. break;  
17. default:  
18.             rc = -1;  
19. break;  
20.     }  
21. return rc;  
22. } 

同樣的，我們這里主要分析一下ALLOW時的iptables的防火牆設置規則，對執行的兩個iptables命令展開來就是下面兩個步驟：

-

1) 在mangle表中追加WiFiDog_$ID$_Outgoing外出過濾鏈，該鏈的規則如下幾條：

   a) IP 地址為該客戶端的IP地址；

   b) MAC地址為該客戶端的MAC地址；

   c) 設置MARK為FW_MARK_KNOWN；

-

iptables –t mangle –AWiFiDog_$ID$_Outgoing  -s 客戶端IP地址 -m mac --mac-source 客戶端MAC地址 -j MARK --set-markFW_MARK_KNOWN

-

2）在mangle表中追加一條[接受所有目的地址為此客戶端IP地址的] WifiDog_$ID$_Incoming輸入過濾鏈；

-

iptables -t mangle -AWiFiDog_$ID$_Incoming -d 客戶端IP地址 -j ACCEPT

-

最后，看一下 wifidog 返回的重定向請求到 認證服務器 的請求報文 以及 認證服務器 返回給 客戶端的（重定向到原始訪問 baidu.com 的）響應報文：