情境: 公司的 WPA2/WPA3-Enterprise 無線網路。
- 公司配發的筆電裝了公司 CA 簽的憑證,用 EAP-TLS 登入,放進設備 VLAN 10。
- 員工自己的手機沒有憑證,用帳號密碼走 PEAP-MSCHAPv2,放進員工 VLAN 20。
- 離職的人或遺失的筆電,在資料表停用就不能登入,不必等憑證撤銷。
範例目錄:rradius-server/examples/scenarios/enterprise-wifi/
| 檔案 | 內容 |
|---|---|
rradius.toml | 設定檔 |
make-certs.sh | 產生示範用的 CA、伺服器憑證和一張筆電憑證 |
migrations/1_schema.sql | accounts(帳號和設備)、group_reply(群組的 VLAN)、accounting |
migrations/2_demo_data.sql | 員工 staff1(啟用)、staff2(停用)、筆電 laptop-001 |
eapol/peap.conf、eapol/tls.conf | eapol_test 的測試設定 |
計費沿用快速開始的 accounting.lua。
步驟
1. 產生憑證
cd rradius-server/examples/scenarios/enterprise-wifi
./make-certs.sh
會在 certs/ 產生 ca.pem、server.pem/server.key(名稱 radius.corp.example.com)和 device.pem/device.key(名稱 laptop-001.corp.example.com)。只供測試。 正式環境的伺服器憑證和用戶端憑證要由公司的 CA 簽發,伺服器私鑰不要離開伺服器。
2. 改 client 位址並啟動
本機測試時,把 [[radius.clients]] 的 address = "10.30.0.10" 改成 127.0.0.1。
cd ../../.. # 回到 rradius-server
./target/release/rradius-server --config examples/scenarios/enterprise-wifi/rradius.toml
3. 用 eapol_test 測試
eapol_test 在 Debian/Ubuntu 的 eapoltest 套件裡。在情境目錄執行,設定檔裡的憑證路徑才對得上:
cd examples/scenarios/enterprise-wifi
eapol_test -c eapol/peap.conf -a 127.0.0.1 -s wlc-shared-secret-change-me
eapol_test -c eapol/tls.conf -a 127.0.0.1 -s wlc-shared-secret-change-me
兩個都要印出 SUCCESS,Access-Accept 裡有 Tunnel-Private-Group-Id(PEAP 是 20,TLS 是 10)。rradius 的認證紀錄:
authentication protocol="radius" client="wlc" source=127.0.0.1 user="anonymous@corp.example.com" account="staff1" chain="eap" handler="eap-peap" decision="accept"
authentication protocol="radius" client="wlc" source=127.0.0.1 user="laptop-001.corp.example.com" account="laptop-001.corp.example.com" chain="eap" handler="eap-tls" decision="accept"
PEAP 的 user 是外層的匿名名稱,account 是內層的真正帳號。
這兩份 eapol_test 設定是在 Docker 裡用 eapoltest 套件實際跑過的;這個情境的自動測試只用 PAP 確認串接和 VLAN,EAP 本身由專案的互通測試涵蓋。第 15 章的自動測試會走完整段 EAP-TLS。
設定說明
[radius.eap]
cert_file = "certs/server.pem"
key_file = "certs/server.key"
client_ca_file = "certs/ca.pem"
methods = ["tls", "peap"]
[[radius.clients]]
name = "wlc"
address = "10.30.0.10"
secret_file = "wlc.secret"
eap_methods = ["tls", "peap"]
client_ca_file是簽發用戶端憑證的 CA, 只信任它,不信任系統的根憑證。methods有兩個以上時,每個 client 都要設eap_methods, 列表順序就是提供順序。用戶端可以拒絕第一個、改要第二個(EAP Nak),所以只想讓某台控制器收憑證的話,那台就只列["tls"]。- 憑證通過不等於可以登入。 握手成功後,憑證上的名稱會交給認證串接決定,所以停用設備只要改資料表。
[[auth.handlers]]
type = "sql"
user_query = "SELECT password FROM accounts WHERE name = ? AND kind = 'user' AND enabled = 1"
certificate_query = "SELECT 1 FROM accounts WHERE name = ? AND kind = 'device' AND enabled = 1"
reply_query = "SELECT r.attribute, r.value FROM accounts a JOIN group_reply r ON r.grp = a.grp WHERE a.name = ?"
- PEAP 用
user_query: MS-CHAPv2 要比對明文或 NT hash,所以密碼存{nthash}(2_demo_data.sql有算法)。存 bcrypt、argon2 的帳號不能走 PEAP,要改用 EAP-TTLS 內層 PAP,見 usage 2.12 節。 - EAP-TLS 用
certificate_query: 查得到就接受。設備沒有密碼,所以不能用user_query(密碼欄是 NULL 會被拒絕)。 reply_query兩種登入都用, 依群組回 VLAN 的三個屬性。Tunnel-Type:1的:1是 tag,三個屬性要用同一個 tag。
[auth.username]
strip_realm = "suffix"
lowercase = true
- 員工可能輸入
Staff1@corp.example.com,查帳號時變成staff1。 - 憑證登入不去掉 realm: 憑證證明的是完整名稱,名稱被改掉的不只大小寫時會拒絕。所以設備存憑證上的完整名稱,而且設備名稱不要有
@。
憑證上的名稱
- rradius 用憑證的 DNS SAN 和 email SAN 當名稱,兩者都沒有才用 CN。用戶端的 EAP Identity 要符合其中一個(
match_identity = true,預設)。 - 用戶端把 Identity 填成匿名值時,設
match_identity = false,改用憑證的第一個名稱。 - 用腳本判斷憑證欄位(例如 OU)時用
tls_subject_attrs,不要對整個主體字串做比對,見 usage 4.2 節。
其他登入方式
這一章用的是最常見的兩種。其他的選擇:
| 情況 | 用什麼 | 哪裡 |
|---|---|---|
| 帳號的密碼只有雜湊(bcrypt、argon2、舊系統搬來的),或要讓 LDAP 用 bind 驗證 | EAP-TTLS 內層 PAP:methods 加 "ttls" | usage 2.12 節、第 17 章 |
| 設備裝了公司自己發的 USIM 卡 | EAP-AKA' | 第 13 章 |
| 設備不會 802.1X,但想要每人不同的 Wi-Fi 密碼 | 每人一把 WPA2 密碼 | 第 12 章 |
| 設備什麼都不會(印表機) | MAC 認證 | 第 4 章 |
上線前
- 用戶端一定要驗證伺服器憑證。 PEAP 的保護全靠 TLS,用戶端不驗證時,假的基地台能拿到密碼的雜湊。用 MDM 或群組原則把 CA 和伺服器名稱(
radius.corp.example.com)推到裝置上,這是最常見的部署錯誤。 - 伺服器憑證 建議帶
serverAuth的 EKU,make-certs.sh有加。 - 撤銷: 設
crl_file時,憑證鏈上每一層 CA 都要有 CRL,更新後送 SIGHUP。CA 只提供 OCSP 時設ocsp。不設的話,停用設備就靠資料表的enabled。做法和取捨見第 15 章。 - 設備漫遊時每次都重做完整握手: 預設是這樣。要讓重新連線的設備恢復上一次的 session,設
resumption_ms,見第 15 章。 - 同一次登入要在同一個節點完成。 多節點時,無線控制器要固定送到同一台(主備),或在負載平衡器依來源固定節點,見第 8 章。
- 這個功能還沒有在實體基地台和各作業系統上測過, 只用
eapol_test驗證過。上線前請用實際的控制器和幾種手機、筆電試一次。
常見問題
| 現象 | 原因 |
|---|---|
啟動失敗,提到 eap_methods | methods 有多個方法,某個 client 沒設 eap_methods |
PEAP 失敗,紀錄 decision="reject" | 帳號不存在、停用、密碼不是明文或 {nthash} |
| EAP-TLS 握手成功但被拒絕 | certificate_query 查不到:名稱和資料表不同,或 kind、enabled 不對 |
| EAP-TLS 紀錄寫 Identity 不符 | 用戶端的 Identity 和憑證的 SAN/CN 都不同,改用戶端設定或設 match_identity = false |
有 UnknownRevocationStatus | 設了 crl_file,但缺少某一層 CA 的 CRL |
| 手機一直跳出「是否信任憑證」 | 裝置上沒有 CA,或伺服器名稱和設定的不同 |