情境: 辦公室有一個 WPA2-PSK 的 SSID(輸入密碼就能連的那種)。印表機、電視、訪客的設備不會 802.1X,所以不能改成第 3 章的企業 Wi-Fi;但全公司共用一把密碼,有人離職就得全部重設。
改成每個人一把自己的密碼,SSID 不變(各廠商叫 DPSK、iPSK、MPSK、PPSK):
- 每個人用自己的密碼連同一個 SSID,rradius 從密碼認出是誰,依人放進不同的 VLAN。
- 離職時只停掉他那一把,其他人不受影響。
- 設備不必先登記 MAC。
AP 有兩種做法,看你的 AP 支援哪一種:
| 做法 | AP 送什麼給 rradius | 設備要先登記嗎 | 本章的位置 |
|---|---|---|---|
| 從四次交握找出是哪一把 | 連線時交握的內容(ANonce 和第 2 個 EAPOL 封包) | 不用 | 主要的做法,[radius.dpsk] |
| 依 MAC 回覆密碼 | 設備的 MAC 位址 | 要 | 第二種做法 |
四次交握是設備和 AP 互相證明知道密碼的過程,密碼本身不會傳出來。rradius 拿每個人的金鑰去試,算得出同樣結果的那一把就是這個人的。
範例目錄:rradius-server/examples/scenarios/psk-wifi/
| 檔案 | 內容 |
|---|---|
rradius.toml | [radius.dpsk]、兩種 AP 各一個 client、[accounts](停用、啟用人)、[accounts.dpsk](金鑰) |
setup.sh | 產生 dpsk.key 和封存好的示範資料 |
mac-psk.lua | 第二種做法的腳本 |
migrations/1_schema.sql | people(人和 VLAN)、dpsk_keys(每人的金鑰)、device_psk(依 MAC 的密碼)、accounting |
步驟
1. 產生金鑰和示範資料
cd rradius-server
cargo build --release
examples/scenarios/psk-wifi/setup.sh
它做兩件事:
- 產生
dpsk.key:封存金鑰用的主金鑰,64 個十六進位字元,權限 0600。 - 用
rradius-server dpsk-seal封存三個示範的人的密碼,寫成migrations/2_demo_keys.sql。
這兩個檔案不在 repo 裡,因為主金鑰不該公開,而封存的結果跟著主金鑰走。已經有的檔案不會覆蓋: 換掉主金鑰,舊的資料就打不開。
用發行檔時 setup.sh 會自己找到 bin/rradius-server;放在別的地方時用 RRADIUS_SERVER=/path/to/rradius-server 指定。
2. 啟動
./target/release/rradius-server --config examples/scenarios/psk-wifi/rradius.toml
3. 測試
四次交握沒辦法用 radtest 模擬, 要有支援的 AP 和一台設備才測得到。自動測試的做法是重放一段事先錄好的交握(由另一個獨立的程式用 bob-passphrase 算出來的),確認:
| 請求 | 結果 |
|---|---|
bob 的交握,SSID office | Access-Accept,VLAN 30,Tunnel-Password 解開是 bob 的 PMK |
| 同一段交握,改掉一個位元 | Access-Reject:沒有人的密碼對得上 |
同一段交握,SSID 換成 guest | Access-Reject:這個 SSID 沒有金鑰 |
user disable bob 之後 | Access-Reject,立刻生效 |
user enable bob 之後 | Access-Accept |
dpsk delete --ssid office bob 之後 | 仍然 Access-Accept(設備上次對上的那把還記著);送 SIGHUP 後 Access-Reject |
dpsk add --ssid office bob(密碼 bob-passphrase)之後 | Access-Accept |
認證紀錄會寫出認到的是誰:
authentication protocol="radius" client="office-aps" source=10.35.0.7 user="020000000099" account="bob" chain="default" handler="dpsk" decision="accept"
user 是 AP 送來的名稱(通常是設備的 MAC),account 是對上密碼的人。
設定說明
[radius.dpsk]
candidates_query = "SELECT identity, pmk FROM dpsk_keys WHERE ssid = ? LIMIT 10000"
key_file = "dpsk.key"
cache_lifetime_ms = 3600000
max_candidates = 10000
candidates_query回傳這個 SSID 所有人的 (身分, 封存的 PMK)。?代入 SSID。rradius 依序逐一試,最多試max_candidates個。- 查詢要自己加
LIMIT。max_candidates只限制試幾個,查詢結果還是整批讀進來。 - PMK 是什麼: WPA2 實際用的金鑰,由密碼和 SSID 算出來。存 PMK 而不存密碼,每次比對就不必重算(重算一次要幾毫秒,試一萬個人就太慢)。拿到 PMK 就能連上那個 SSID, 所以資料表裡只放封存過的;沒封存的值打不開,會被略過。
key_file是封存用的主金鑰。每個節點都要放同一把,權限只能是 0600、0640 或 0400 這類,否則啟動失敗。要另外備份: 它不在資料庫裡,遺失就要請每個人重設密碼。cache_lifetime_ms: 記住每台設備在這個 SSID 上次對上的那一把,下次先試它,不必查資料庫。對不上(設備換了密碼)就忘掉,重新找。
有多快: 在開發用的機器上量,試完一萬個候選約 11 毫秒,五萬個約 55 毫秒;用記住的那一把不到 1 微秒。同時最多 4 個搜尋,再多的請求直接丟棄,由 AP 重送。AP 和設備在交握中願意等多久因廠商而異,沒有實機確認,人數很多時請先實測。量測見 usage 2.15 節。
對上之後:這個人能不能連
[[auth.handlers]]
type = "sql"
user_query = "SELECT NULL FROM people WHERE identity = ?"
certificate_query = "SELECT 1 FROM people WHERE identity = ? AND enabled = 1"
reply_query = """WITH p AS (SELECT vlan FROM people WHERE identity = ?)
SELECT 'Tunnel-Type:1', 'VLAN' FROM p
UNION ALL SELECT 'Tunnel-Medium-Type:1', 'IEEE-802' FROM p
UNION ALL SELECT 'Tunnel-Private-Group-Id:1', vlan FROM p"""
密碼對上只證明「這是 bob」。接著身分會交給這個 client 的認證串接,當成已經證明的名稱,和憑證登入相同:
certificate_query查得到就接受。把停用條件寫在這裡(enabled = 1),停用一個人就立刻生效,不必等記住的金鑰到期。reply_query給這個人的 VLAN。reply_query只能有一個?,所以用WITH查一次、回三列。user_query是必填的,但這個 SSID 沒有帳號密碼登入。範例讓密碼欄一律是NULL:只帶名稱和密碼的請求都會被拒絕。- 用腳本決定時,腳本看到的
eap_method是'dpsk',get_attr('User-Name')是對上的身分。 - 接受時,rradius 自動把 PMK 加進回覆, AP 才能完成交握:hostapd 的請求回
Tunnel-Password,Ruckus 的回Ruckus-DPSK。這兩個屬性不用自己設。 - 對不上任何人時直接回 Access-Reject, 不經過串接和腳本。
新增、停用、換密碼
新增一個人
# 先把 dave 加進 people 表(決定 VLAN,見下方),再加他在 office 的金鑰。
printf '%s\n' 'dave-passphrase' | rradius-server dpsk add --config rradius.toml --ssid office dave
# added key of dave for office
密碼從標準輸入讀, 不放在參數裡(參數會留在 shell 歷史)。在終端機上會問兩次、不顯示。密碼要是 8 到 63 個可列印的 ASCII 字元,或 64 個十六進位字元的 PSK。
寫進資料表的是封存後的 PMK, 綁定身分和 SSID,搬到別人名下或別的 SSID 都打不開。同一把密碼要用在兩個 SSID,就各執行一次。密碼本身不會存下來。
要在有
key_file的主機上執行, 通常就是節點本身。寫入經過叢集,所有節點立刻看得到,不必重啟。執行哪一條 SQL 寫在
[accounts.dpsk]:?1是身分、?2是 SSID、?3是封存好的 PMK。範例:[accounts.dpsk] add = "INSERT INTO dpsk_keys (identity, ssid, pmk) VALUES (?1, ?2, ?3)" passwd = "UPDATE dpsk_keys SET pmk = ?3 WHERE identity = ?1 AND ssid = ?2" delete = "DELETE FROM dpsk_keys WHERE identity = ?1 AND ssid = ?2" show = "SELECT identity, ssid FROM dpsk_keys WHERE identity = ?1 AND ssid = ?2"delete和show可以不用?2,一次處理這個人所有的 SSID;指令仍然要給--ssid,但不會代入,結果印成deleted keys of bob。完整規則見參考文件 2.14 節。人的那一列 在
people表,決定能不能連和 VLAN。範例的[accounts]只設了enable、disable、show;要用user add新增人,在[accounts]加一條寫people的add(它會要一個密碼值,這個情境用不到,可以寫進一個不用的欄位,或直接用 SQL 加)。大量匯入 仍可以用
dpsk-seal產生封存值,寫成一個 migration 檔(第一次上線時常用,見setup.sh的做法)。
停用和啟用
rradius-server user disable --config rradius.toml bob
rradius-server user enable --config rradius.toml bob
rradius-server user show --config rradius.toml bob
範例的 [accounts] 改的是 people 表的 enabled。整個叢集立刻生效,下一次連線就被拒絕。已經連上的設備不會被踢下線, 要等它重新連線(漫遊、休眠後回來);要立刻斷線,見第 7 章的 CoA。
換密碼、刪除
printf '%s\n' 'new-passphrase' | rradius-server dpsk passwd --config rradius.toml --ssid office bob
rradius-server dpsk delete --config rradius.toml --ssid office bob
rradius-server dpsk show --config rradius.toml --ssid office bob
結果是 key changed for bob for office、deleted key of bob for office;沒有這一列時印 no key of bob for office,狀態 1。
之後要對每個節點送 SIGHUP: rradius 記著每台設備上次用的那一把,不送的話,那些設備在 cache_lifetime_ms 內還能用舊密碼連上。指令只改資料表,不會通知節點。只靠 enabled = 0 停用時不必,因為每次連線都會查 certificate_query。
換主金鑰
每個節點把新的設成 key_file、舊的設成 previous_key_file,送 SIGHUP;這段期間兩把都打得開。把每個人的密碼用新金鑰重新封存、換掉資料表裡的值之後,再拿掉 previous_key_file。dpsk passwd 和 dpsk-seal 都只接受密碼(或 64 個十六進位字元的 PSK),不能直接把舊的封存值換成新的,所以要有原本的密碼。
第二種做法:依 MAC 回覆密碼
AP 不會送四次交握時(Cisco iPSK、Aruba MPSK、Meraki、Mist,或 hostapd 的 wpa_psk_radius=1、2),它在設備連線時用 MAC 位址問 rradius「這台的密碼是什麼」。每台設備要先登記。這種做法不需要 [radius.dpsk]。
[auth.chains.mac-psk]
policy = "first_match"
[[auth.chains.mac-psk.handlers]]
type = "lua"
script = "mac-psk.lua"
[[radius.clients]]
name = "lab-aps"
address = "10.36.0.0/24"
secret_file = "lab-aps.secret"
auth = "mac-psk"
mac-psk.lua 做的事:
User-Name和Calling-Station-Id要是同一個 MAC(各種寫法都先統一成 12 個小寫十六進位字元)。- 查
device_psk表,查不到就拒絕。 - 用
set_attr('Tunnel-Password', ...)回覆密碼,rradius 會用共用密碼加密;再回 VLAN。
本機測試(把 lab-aps 的 address 改成 127.0.0.1):
echo 'User-Name=00-11-22-33-44-AA,User-Password=00-11-22-33-44-AA,Calling-Station-Id=00:11:22:33:44:aa' \
| radclient -x 127.0.0.1:1812 auth lab-aps-secret-change-me
會收到 Access-Accept,帶 Tunnel-Password 和 VLAN 40。
- 各廠商要的屬性不同: 範例用的
Tunnel-Password適用 hostapd、Meraki、Mist。Cisco 用Cisco-AVPair,Aruba 用Aruba-MPSK-Passphrase,Ruckus 用Ruckus-DPSK(要用wpa_pmk函式算出 PMK),寫法見 usage 2.15 節。 - 資料表裡是明文的密碼, 因為 AP 要拿到密碼本身。讀得到資料庫的人就看得到。
Cisco-AVPair的值不會加密, 只在可信任的網路或 RadSec 上用。- MAC 不是秘密。 別人可以冒用登記過的 MAC 來問,但問到的密碼是加密後給 AP 的,設備還是要自己知道密碼才連得上。
上線前
- 只支援 WPA2-PSK(HMAC-SHA1 的那一種)。 WPA3-SAE、WPA2-PSK-SHA256 和強制 PMF(管理訊框保護)時用的版本都不支援,收到時回 Access-Reject,記錄寫
key descriptor version 3 is not supported。SSID 要設成純 WPA2-PSK,PMF 不能設成「必要」。 - 支援的 AP: hostapd 2.11 以後的
wpa_psk_radius=3,和會送Ruckus-DPSK-Params的 Ruckus AP。AP 的 MAC 和 SSID 從Called-Station-Id讀(格式AA-BB-CC-DD-EE-FF:SSID),設備的 MAC 從Calling-Station-Id讀。 - 密碼要夠長、每個人不同。 兩個人設了同一把密碼時,認到的是查詢結果裡排前面的那個人。
- 不要讓使用者自己選太短的密碼: 聽得到無線訊號的人可以錄下交握離線猜密碼,這是 WPA2-PSK 本身的限制。
- 沒有測過的: 任何實體 AP。四次交握的比對和 FreeRADIUS 3.2.10 的
dpsk模組交叉確認過(同一段交握,兩邊找出同一把密碼);Ruckus 的回覆格式來自它的字典說明和社群討論,沒有官方文件;第二種做法各廠商的屬性沒有用實體設備驗證過。
常見問題
| 現象 | 原因 |
|---|---|
啟動失敗,提到 dpsk.key | 還沒執行 setup.sh,或檔案的權限太寬(要 0600 這類) |
每個人都連不上,記錄有 do not open with key_file | 資料表裡的值不是用這把 dpsk.key 封存的,或封存時的身分、SSID 和資料列不同 |
記錄有 key descriptor version 3 is not supported | SSID 開了 PMF 必要或 SHA256,改成純 WPA2-PSK |
記錄有 Called-Station-Id ... is not <access point MAC>:<SSID> | AP 送的 Called-Station-Id 沒有帶 SSID,調整 AP 的設定 |
密碼對了還是被拒絕,紀錄的 account 有名字 | 密碼對上了,但 certificate_query 查不到:這個人被停用,或 people 表沒有他 |
請求被當成一般登入,handler 不是 dpsk | AP 沒有送交握的屬性:AP 不支援這種做法,或沒有開(hostapd 是 wpa_psk_radius=3) |
| 刪掉金鑰後還能連 | 沒有送 SIGHUP,設備上次用的那一把還記著 |
rradius_dpsk_total{result="busy"} 增加 | 同時超過 4 個搜尋:人數太多或同時連線太多,縮小每個 SSID 的候選 |