10. RadSec:NAS 經過不信任的網路

情境: 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 的差別

UDPRadSec
埠認證 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 簽的任何憑證都能當成這個 clientCA 只簽給 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

三種做法,由快到慢:

  1. 拿掉它的 [[radius.clients]] 項目,送 SIGHUP。 已開啟的連線收到下一個封包時就關閉。
  2. 撤銷憑證: 設 crl_file,把新的撤銷清單放上去再送 SIGHUP。之後這張憑證握不了手,已開啟的連線也會在重新檢查時關閉(SIGHUP 當下,和之後每分鐘一次)。撤銷清單要涵蓋憑證鏈上每一層 CA,缺一層就會擋下所有設備。
  3. 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 ... failedNAS 沒有出示憑證、憑證不是 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
踢人回 502NAS-Identifier 不是 client 的 name、那台 NAS 沒有連線開著,或它連在別的節點
踢人回 505NAS 在 coa_timeout_ms 內沒有回答:它不支援在這條連線上收 CoA
連線每 5 分鐘斷一次閒置逾時,調高 idle_timeout_ms 或讓 NAS 送 Status-Server
使用 Hugo 建立
主題 Stack 由 Jimmy 設計