12. 每人一把 Wi-Fi 密碼

情境: 辦公室有一個 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.sqlpeople(人和 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 officeAccess-Accept,VLAN 30,Tunnel-Password 解開是 bob 的 PMK
同一段交握,改掉一個位元Access-Reject:沒有人的密碼對得上
同一段交握,SSID 換成 guestAccess-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 做的事:

  1. User-Name 和 Calling-Station-Id 要是同一個 MAC(各種寫法都先統一成 12 個小寫十六進位字元)。
  2. 查 device_psk 表,查不到就拒絕。
  3. 用 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 supportedSSID 開了 PMF 必要或 SHA256,改成純 WPA2-PSK
記錄有 Called-Station-Id ... is not <access point MAC>:<SSID>AP 送的 Called-Station-Id 沒有帶 SSID,調整 AP 的設定
密碼對了還是被拒絕,紀錄的 account 有名字密碼對上了,但 certificate_query 查不到:這個人被停用,或 people 表沒有他
請求被當成一般登入,handler 不是 dpskAP 沒有送交握的屬性:AP 不支援這種做法,或沒有開(hostapd 是 wpa_psk_radius=3)
刪掉金鑰後還能連沒有送 SIGHUP,設備上次用的那一把還記著
rradius_dpsk_total{result="busy"} 增加同時超過 4 個搜尋:人數太多或同時連線太多,縮小每個 SSID 的候選
使用 Hugo 建立
主題 Stack 由 Jimmy 設計