情境: NAS 和 rradius 之間隔著網際網路,或一段你不信任的網路。RADIUS 的 UDP 只用共用密碼和 MD5 保護一部分內容,不適合直接走這種網路。改用 RadSec(RADIUS over TLS,RFC 6614):整個封包都在 TLS 裡,雙方用憑證確認彼此。
- 總部的無線控制器 位址固定,用憑證加位址辨認。
- 分店的閘道 在 NAT 後面,沒有固定位址,只靠憑證辨認。
- 要踢分店的使用者時, rradius 連不到 NAT 後面的閘道,所以請求走閘道自己連進來的那條 RadSec 連線。
- 總部的管理系統 也經 RadSec 連進來,在同一條連線上送踢人的請求。
範例目錄:rradius-server/examples/scenarios/radsec/
| 檔案 | 內容 |
|---|---|
rradius.toml | [radius.tls]、三種 client、[radius.coa] |
make-certs.sh | 產生示範用的 CA、伺服器憑證和三張用戶端憑證 |
migrations/ | 帳號(結構同快速開始)和示範帳號 alice |
hq-wlc.secret、helpdesk.secret | 控制器走 UDP 時的共用密碼、客服系統送 CoA 的共用密碼 |
和 UDP 的差別
| UDP | RadSec | |
|---|---|---|
| 埠 | 認證 1812、計費 1813 | 一個 TCP 埠 2083,認證、計費、Status-Server 共用一條連線 |
| 怎麼認得 NAS | 來源位址 | 來源位址、憑證,或兩者 |
| 共用密碼 | 每台 NAS 自己的 | 固定是 radsec(RFC 規定),保護靠 TLS |
| Message-Authenticator 的設定 | 適用 | 不適用,完整性由 TLS 保障 |
連進來之後,請求走的路和 UDP 完全相同:同樣的認證串接、腳本、EAP、依 realm 轉送和計費暫存。
步驟
1. 產生憑證
cd rradius-server/examples/scenarios/radsec
./make-certs.sh
certs/ 裡會有 ca.pem、伺服器的 server.pem/server.key(名稱 radius.example.net),和三張用戶端憑證:hq-wlc、branch-gw、noc。只供測試。 正式環境請用專門簽發給 NAS 的私有 CA(見下方「上線前」)。
2. 啟動
cd ../../.. # 回到 rradius-server
./target/release/rradius-server --config examples/scenarios/radsec/rradius.toml
記錄會有 RadSec listening on 0.0.0.0:2083。
3. 確認握手
還沒有 NAS 時,先用 openssl 拿分店閘道的憑證連一次,確認憑證這一段是通的:
cd examples/scenarios/radsec
openssl s_client -connect 127.0.0.1:2083 -servername radius.example.net \
-CAfile certs/ca.pem -cert certs/branch-gw.pem -key certs/branch-gw.key
- 看到
Verify return code: 0 (ok)就是雙方的憑證都通過了。按 Ctrl+C 結束。 curl -s http://127.0.0.1:9812/metrics | grep rradius_radsec_connections的result="accepted"會加 1。- 換成
hq-wlc的憑證再連一次:握手會成功,但連線馬上被關閉,記錄寫its certificate fits no client。原因是hq-wlc這個 client 有address,只接受從10.30.0.10來的連線,而其他只靠憑證辨認的 client 都不是這個名稱。
openssl 只能確認握手。真正的登入要由會講 RadSec 的 NAS 或代理送出;自動測試用程式做了這一段:以 branch-gw 的憑證連線,登入 alice(Access-Accept,帶 Filter-Id = "staff")並送計費。
4. NAS 的設定
每台 NAS 的設定方式不同,要設定的項目是同一組:
| 項目 | 值 |
|---|---|
| 伺服器位址和埠 | rradius 的位址,TCP 2083 |
| 傳輸方式 | RadSec、RADIUS over TLS,或「TLS」 |
| 信任的 CA | 簽發 rradius 伺服器憑證的 CA(範例的 ca.pem) |
| 伺服器名稱 | 伺服器憑證上的名稱(範例的 radius.example.net) |
| 用戶端憑證和私鑰 | 這台 NAS 自己的(範例的 branch-gw.pem、branch-gw.key) |
| 共用密碼 | radsec |
設定說明
[radius.tls]
bind = "0.0.0.0"
port = 2083
cert_file = "certs/server.pem"
key_file = "certs/server.key"
client_ca_file = "certs/ca.pem"
min_tls_version = "1.2"
network_clients_need_tls_name = true
client_ca_file是簽發 NAS 憑證的 CA。 rradius 只信任它,不信任系統的根憑證。沒有憑證、或憑證不是它簽的 NAS,握手就失敗。min_tls_version預設"1.2"。所有 NAS 都支援 TLS 1.3 時可以改成"1.3"。[radius]一定要有, RadSec 是它底下的一個區段。UDP 的 1812、1813 照常開著;不想讓 UDP 從外面連進來,用防火牆擋。
三種 client
[[radius.clients]]
name = "hq-wlc"
address = "10.30.0.10"
tls_name = "hq-wlc.example.net"
secret_file = "hq-wlc.secret"
[[radius.clients]]
name = "branch-gw"
tls_name = "branch-gw.example.net"
secret = "unused-on-radsec-change-me"
max_radsec_connections = 4
| 設定 | 怎麼比對 | 適合 |
|---|---|---|
只有 address | 來源位址。同一個 CA 簽的任何憑證都能當成這個 client | CA 只簽給 NAS、位址固定 |
address 加 tls_name | 來源位址,而且憑證要對這個名稱有效 | 位址固定的 NAS,範例的 hq-wlc |
只有 tls_name | 憑證要對這個名稱有效,來源是其他項目都沒涵蓋的位址 | NAT 後面、位址會變的 NAS,範例的 branch-gw |
tls_name比對憑證的 DNS SAN, 憑證上的萬用字元也算;不看 CN。- 來源位址優先。 來源落在某個有
address的項目內,就由那個項目處理,憑證不會把連線移到別的 client。所以只靠憑證辨認的 NAS,來源不能落在其他 client 的網段裡。 secret仍然必填。 RadSec 用不到它;有address的 client 走 UDP 時才用。- 只有
tls_name的 client 只能走 RadSec, UDP 比對不到它。 max_radsec_connections限制這個 client 最多同時開幾條連線。沒設時,一張憑證可以占滿[radius.tls]的max_connections(預設 1024)。- 網段 client 要小心。
address是網段又沒有tls_name時,網段裡任何位址拿這個 CA 的任何憑證都能連。範例設了network_clients_need_tls_name = true,這種 client 就不接受 RadSec 連線(照樣可以走 UDP)。
腳本知道是哪台 NAS
請求走 RadSec 時,腳本可以讀連線的憑證:radsec_subject 是主體的文字,radsec_subject_attrs.CN[1] 是其中一個欄位。它說的是 NAS 是誰,不是使用者是誰。UDP 的請求和重放的計費是 nil。見 usage 4.2 節。
踢人:請求走 NAS 自己的連線
分店閘道在 NAT 後面,rradius 沒有位址可以送 Disconnect-Request。只有 tls_name 的 client 有連線開著時,rradius 改在它連進來的那條 RadSec 連線上送。
[radius]
coa_timeout_ms = 2000
[radius.coa]
bind = "0.0.0.0"
port = 3799
[[radius.coa.clients]]
name = "helpdesk"
address = "10.30.0.50"
secret_file = "helpdesk.secret"
客服系統(helpdesk)用 UDP 把請求送到 rradius 的 3799 埠,用 NAS-Identifier 指出是哪台 NAS:
echo 'User-Name=alice,NAS-Identifier=branch-gw,Acct-Session-Id=rs-1' \
| radclient 127.0.0.1:3799 disconnect helpdesk-coa-secret-change-me
(本機測試時先把 helpdesk 的 address 改成 127.0.0.1。)
- 怎麼找 NAS: 依序用請求裡的
NAS-IP-Address、NAS-IPv6-Address、NAS-Identifier比對 client 的位址或name。branch-gw沒有位址,所以用名稱。 - 在連線上只送一次, 等
coa_timeout_ms。TCP 不會掉封包,所以不看coa_attempts。 - 閘道沒有連線開著時, 回 NAK,
Error-Cause是 502(Request Not Routable)。上面的指令在沒有閘道連著時就會得到這個結果。 - NAS 要願意在自己開的連線上收 Disconnect 和 CoA。 不是每台設備都支援,先向廠商確認。
- 腳本也可以送:
send_disconnect('branch-gw', {...})走同一條連線。沒有連線時腳本會出錯。命令列的rradius-server disconnect不在伺服器裡執行,拿不到連線,所以不能以這種 client 為目標。 - 叢集裡只有握著那條連線的節點送得出去。 閘道連到 node1 時,請求要送給 node1;送到別的節點會得到 502。
管理系統也走 RadSec:coa_sender
[[radius.clients]]
name = "noc"
tls_name = "noc.example.net"
secret = "unused-on-radsec-change-me"
coa_sender = true
送出端本來就經 RadSec 連到 rradius 時,設 coa_sender = true,它就能在同一條連線上送 Disconnect-Request 和 CoA-Request,不必另外開 UDP、設共用密碼。回答寫回同一條連線。
- 預設關閉。 送出端和 NAS 共用 2083 埠,防火牆分不開兩者,只能靠這個設定決定誰可以讓使用者斷線。沒設的 client 送來時丟棄,記錄
is not a coa_sender。 - 需要
[radius.coa]和[radius.tls]。 只經 RadSec 收的話,[[radius.coa.clients]]可以不寫,但 3799 的 UDP 埠照樣會開。
完整的規則(只給使用者名稱時查 session、依 realm 轉給上游、各種 NAK)見第 7 章和 usage 4.8 節。
撤銷一台 NAS
三種做法,由快到慢:
- 拿掉它的
[[radius.clients]]項目,送 SIGHUP。 已開啟的連線收到下一個封包時就關閉。 - 撤銷憑證: 設
crl_file,把新的撤銷清單放上去再送 SIGHUP。之後這張憑證握不了手,已開啟的連線也會在重新檢查時關閉(SIGHUP 當下,和之後每分鐘一次)。撤銷清單要涵蓋憑證鏈上每一層 CA,缺一層就會擋下所有設備。 - CA 只提供 OCSP 時 設
ocsp,做法和 EAP-TLS 相同,見第 15 章。
上線前
- CA 只簽給 NAS。
client_ca_file的 CA 也簽使用者的 EAP-TLS 憑證時,使用者的憑證就能拿來當 NAS 連進來(只有address的 client 擋不住)。用另一個 CA,或每個 client 都設tls_name。 - 用防火牆限制 2083 的來源。 有只靠憑證辨認的 client 時,握手前不能用來源位址擋下陌生連線,任何連得到這個埠的人都能消耗 TLS 握手。
- 憑證到期前要換。 過期的憑證握不了手,已開啟的連線最多再多開一分鐘。伺服器的憑證換好後送 SIGHUP,新連線用新的,已開啟的不受影響。
- 放在負載平衡器後面 時,負載平衡器要用 TCP 模式並送 PROXY protocol 標頭,位址列在
proxy_protocol_from;TLS 仍由 rradius 處理。見 usage 2.7 節。 - 同一個埠給不同的名稱不同的憑證(多租戶)用
[[radius.tls.certificates]],見同一節。 - 閒置的連線 300 秒沒有完整封包就關閉(
idle_timeout_ms),NAS 會重新連線。NAS 定期送 Status-Server 就不會被關。 - 沒有測過的: 任何實體 NAS 的 RadSec。互通測試用 FreeRADIUS 3.2.10 當代理測過認證、計費和 CoA。在 NAS 自己的連線上送 CoA 只用程式模擬的 NAS 測過。
常見問題
| 現象 | 原因 |
|---|---|
記錄有 RadSec handshake with ... failed | NAS 沒有出示憑證、憑證不是 client_ca_file 簽的、已被撤銷,或 TLS 版本不合 |
RadSec connection from unknown client | 來源不在任何 client 的位址裡,也沒有只靠憑證辨認的 client |
握手成功但馬上斷線,its certificate fits no client | 憑證的名稱不是任何只有 tls_name 的 client;或來源落在某個有 address 的 client 裡,而憑證對它的 tls_name 無效(這時訊息是 is not valid for client ...'s tls_name) |
has no tls_name, which network_clients_need_tls_name asks for | 網段 client 沒有 tls_name,又開了 network_clients_need_tls_name |
| 連上了,但每個請求都沒有回應 | NAS 的共用密碼不是 radsec |
| 踢人回 502 | NAS-Identifier 不是 client 的 name、那台 NAS 沒有連線開著,或它連在別的節點 |
| 踢人回 505 | NAS 在 coa_timeout_ms 內沒有回答:它不支援在這條連線上收 CoA |
| 連線每 5 分鐘斷一次 | 閒置逾時,調高 idle_timeout_ms 或讓 NAS 送 Status-Server |