情境: 一所學校(範例的 realm 是 uni-a.example)加入漫遊聯盟。聯盟的成員互相承認帳號:任何成員的使用者到了別的成員那裡,都能用自己學校的帳號連上 Wi-Fi。
- 本校的人在本校:
student1@uni-a.example在本機認證。 - 外校的人來訪:
bob@uni-b.example轉給他自己的學校。成員太多,無法一一設定,所以依 realm 查 DNS 找出對方的伺服器;查不到的交給全國代理。 - 本校的人到外校: 請求從聯盟經 RadSec 送回來,由本機認證。
- 姊妹校 在同一條專線上,有兩台伺服器,要把使用者分攤過去。
- 上游都停擺時, 轉送的計費不能遺失。
這一章接在第 9 章(依 realm 轉送的基本做法)和第 10 章(RadSec)之後,那兩章講過的不再重複。
範例目錄:rradius-server/examples/scenarios/roaming/
| 檔案 | 內容 |
|---|---|
rradius.toml | [proxy]、[proxy.discovery]、[proxy.accounting_spool]、[radius.tls] |
make-certs.sh | 產生示範用的聯盟 CA、本校的 RadSec 憑證、一張假裝是全國代理的憑證,和 PEAP 用的伺服器憑證 |
migrations/ | 本校的帳號(結構同快速開始)和示範帳號 student1 |
wlc.secret、uni-b.secret | 校園控制器、姊妹校的共用密碼 |
一個請求往哪裡去
student1 沒有 @ ─────────────────────────────► 本機
student1@uni-a.example 在 local_realms ────────────────────► 本機
bob@uni-b.example [[proxy.realms]] 完全相同 ──────────► uni-b-1、uni-b-2(分攤)
carol@dept.gov.example [[proxy.realms]] 的 *.gov.example ──► 全國代理
dave@uni-c.example 沒有項目 → 查 DNS ─┬─ 查到 ────────► uni-c 自己的 RadSec 伺服器
├─ DNS 說沒有 ──► [[proxy.realms]] 的 * → 全國代理
└─ 查詢失敗 ────► 丟棄,NAS 重送時再查
- 順序: 完全相同的 realm → 涵蓋它的
*.項目 →local_realms→ DNS →*。*只在 DNS 明確說「沒有」時才用。 - 轉送的請求不在本機處理。 802.1X 的整段 EAP 對話原樣轉給對方,密碼和金鑰都由對方處理,本機看不到密碼。
- 本機的
[radius.eap]只服務留在本機的請求(本校的使用者)。
步驟
1. 產生憑證並啟動
cd rradius-server/examples/scenarios/roaming
./make-certs.sh
cd ../../..
./target/release/rradius-server --check --config examples/scenarios/roaming/rradius.toml
--check 會確認每台上游的憑證讀得到、私鑰和憑證配對。範例的上游位址都是文件用的假位址, 啟動後本校的帳號可以登入,轉送的請求不會有回應。要在本機看到轉送,照第 9 章的步驟另開一份快速開始當姊妹校,把 uni-b-1、uni-b-2 指過去。
本機測試時,把 campus-wlc 的 address 改成 127.0.0.1:
./target/release/rradius-server --config examples/scenarios/roaming/rradius.toml
radtest Student1@uni-a.example student1-password 127.0.0.1 0 campus-wlc-secret-change-me
會收到 Access-Accept,帶 Filter-Id = "campus"。
2. 正式環境要換掉的
- 向聯盟申請 RadSec 憑證, 並拿到聯盟的 CA。取代
certs/radius.pem、certs/radius.key、certs/federation-ca.pem。 local_realms、[[radius.clients]]的全國代理名稱、flr-1/flr-2的位址和tls_name換成聯盟給的值。[radius.eap]的憑證 換成你要給自己的使用者看的那一張,見第 3 章。- 在 DNS 發布自己的 NAPTR 和 SRV 記錄, 別的成員才找得到你。記錄的格式由聯盟規定。
設定說明
依 DNS 找對方的伺服器
[proxy.discovery]
ca_file = "certs/federation-ca.pem"
cert_file = "certs/radius.pem"
key_file = "certs/radius.key"
service = "x-eduroam:radius.tls"
local_realms = ["uni-a.example", "*.uni-a.example"]
lookup_timeout_ms = 5000
realm_names_only = true
probe_interval_ms = 30000
沒有 [[proxy.realms]] 項目的 realm 會查 DNS(RFC 7585):先查 realm 的 NAPTR 記錄,取 service 相符的,再查它指向的 SRV 記錄和主機位址,最多取 8 個位址。找到的伺服器一律用 RadSec,依 DNS 給的順序容錯。
local_realms一定要列自己的 realm。 聯盟成員通常也替自己的 realm 發布 NAPTR;沒列的話,自己的使用者會被查到自己的 RadSec 伺服器,轉出去再繞回來,進不了本機的 EAP 和串接。service預設是 RFC 7585 的aaa+auth:radius.tls.tcp,eduroam 用x-eduroam:radius.tls。ca_file是聯盟的 CA, 對方的憑證要由它簽發。cert_file、key_file是出示給對方的憑證,多數聯盟要求雙向驗證。realm_names_only = true: 對方的憑證一定要對 realm 本身 有效(DNS 名稱,或 NAIRealm 欄位)。設成false(預設)時,對 SRV 記錄指向的主機名稱有效也算。差別在於:rradius 不做 DNSSEC,主機名稱來自沒有驗證的 DNS 回答,所以false時,能竄改 DNS 又持有聯盟任何一張憑證的人(例如另一個成員),可以把別的 realm 的請求導到自己那裡。聯盟的憑證上有 realm 名稱時就打開;聯盟只發主機名稱的憑證時,打開會連不上。lookup_timeout_ms: 一個 realm 整段查詢最多等這麼久。realm 來自使用者輸入的名稱,DNS 記錄由那個網域的擁有者決定,所以查詢有上限:每個節點同時最多 16 個查詢,同一個 realm 同時只查一次。正在查或名額用完時,這個請求直接丟棄,NAS 重送時多半已經查好。- 結果會記住: 查到的依 DNS 的 TTL 保留(至少 60 秒、最多一天);DNS 說沒有的記 5 分鐘;最多記 4,096 個 realm。SIGHUP 時清空。
- 查詢失敗不等於沒有。 逾時、SERVFAIL、DNS 伺服器連不到時:
- 這個 realm 以前查到過,就繼續用上次的伺服器,30 秒後再查。
- 以前沒查到過,這個 realm 的請求丟棄 30 秒,不會改送
*,也不會留在本機。送錯地方的計費會被別人記帳,所以寧可不回應。
probe_interval_ms: 找到的伺服器閒置這麼久,就送 Status-Server 確認它還在。
全國代理
[[proxy.servers]]
name = "flr-1"
address = "198.51.100.1"
transport = "tls"
tls_name = "flr1.roam.example"
ca_file = "certs/federation-ca.pem"
cert_file = "certs/radius.pem"
key_file = "certs/radius.key"
probe_interval_ms = 30000
[[proxy.realms]]
name = "*.gov.example"
servers = ["flr-1", "flr-2"]
[[proxy.realms]]
name = "*"
servers = ["flr-1", "flr-2"]
*是 DNS 查不到時的出口。 沒有發布 DNS 記錄的成員就靠全國代理轉送。- 已知沒有 DNS 記錄的單位,直接列出來(範例的
*.gov.example),省掉每 5 分鐘一次的查詢。 probe_interval_ms(主動檢查): 沒設時,上游只在真的請求逾時後才被判定停擺。備援的flr-2平常沒有流量,等主機掛了才發現它也掛了就太晚。設了之後,上游超過這段時間沒有任何回應,就送一次 Status-Server;連續 3 次沒回應判定停擺,rradius_proxy_server_alive變成 0,可以拿來告警。有流量的上游不會多收任何封包。上游要會回答 Status-Server。- RadSec 上游的其他規則(一條長連線、不重送、同時 256 個請求)見第 9 章。
聯盟連進來
[radius.tls]
port = 2083
cert_file = "certs/radius.pem"
key_file = "certs/radius.key"
client_ca_file = "certs/federation-ca.pem"
network_clients_need_tls_name = true
[[radius.clients]]
name = "flr-1-in"
tls_name = "flr1.roam.example"
secret = "unused-on-radsec-change-me"
本校的人在外校登入時,請求經全國代理送到這裡的 2083 埠。全國代理只靠憑證辨認(只有 tls_name),它們的位址換了也不用改設定。進來的請求名稱是 student1@uni-a.example,在 local_realms 裡,所以留在本機,由 [radius.eap] 和串接處理。
直接連進來的其他成員: 別的成員用 DNS 找到你時,會直接連你的 2083 埠,不經過全國代理。連進來的對端要符合某個 [[radius.clients]] 項目,否則握手後就被關閉。兩種做法:
- 每個對端一個項目,
tls_name是它憑證上的名稱。最嚴格,但成員很多時列不完,可以請對方經全國代理送來。 - 一個涵蓋對端位址範圍的網段項目,不設
tls_name。 這個網段裡拿聯盟 CA 任何一張憑證的對端都能連進來(第 10 章的表)。這時不能開network_clients_need_tls_name,啟動時會有一行警告;這個網段用 UDP 也進得來(靠secret),所以secret要用夠長的隨機值,並用防火牆擋掉它的 UDP。範例沒有這樣設,情境測試也沒有涵蓋這個做法。
分攤到多台上游
[[proxy.servers]]
name = "uni-b-1"
address = "10.41.0.1"
secret_file = "uni-b.secret"
weight = 1
[[proxy.servers]]
name = "uni-b-2"
address = "10.41.0.2"
secret_file = "uni-b.secret"
weight = 3
[[proxy.realms]]
name = "uni-b.example"
servers = ["uni-b-1", "uni-b-2"]
balance = "load-balance"
strip_realm = true
balance = "load-balance": 預設的failover都先送第一台。改成load-balance後,每個請求依Calling-Station-Id和User-Name算出一個固定的順序,先送排第一的那台。- 同一台設備一直到同一台上游: EAP 整段對話的每個請求,和同一個 session 的計費 Start、Interim-Update、Stop 都會到同一台,不需要另外設定。每個節點、每次重啟算出的結果都相同。
weight: 分到的比例和它成正比,範例的uni-b-2分到約四分之三。只有load-balance會看它。- 一台停擺時, 只有原本排它第一的設備換台,其他設備不受影響。換台的設備正在進行的 EAP 對話會失敗,NAS 會重新開始。
- 使用者很少時可能偏向一台, 因為分配取決於名稱和 MAC 的分布。
自動測試用 24 台不同 MAC 的設備登入同一個帳號:兩台上游都收到請求,weight = 3 的那台收到比較多。
上游全掛時暫存計費
[proxy.accounting_spool]
dir = "spool/proxy"
replay_interval_ms = 5000
replay_window = 32
沒有這個區段時,轉送的計費在所有上游都沒回應時不回覆,NAS 重送幾次後就遺失。設定後:
- realm 的每台上游都沒有回應時,請求先寫到本機的
dir,落盤後回覆 NAS。 - 背景工作從最舊的開始再送,一次最多同時送
replay_window筆,Acct-Delay-Time會加上等待的時間。上游還是沒回應時,隔replay_interval_ms再試。 - 上游回應後,這一筆才算完成。
- 只暫存計費。 登入要即時的答案,上游沒回應時不回覆,讓 NAS 改用它的備援。
- 至少一次: 程序在上游回應和記錄進度之間中斷時,同一筆會再送一次。上游要能容忍重複,通常用
Acct-Session-Id判斷。 - 順序: 同一批裡,同一個 session 的 Start 和 Stop 可能顛倒到達。上游要求嚴格順序時設
replay_window = 1,代價是重送變慢。 - 所有 realm 共用一個佇列。 一個 realm 的上游一直不回應時,其他 realm 暫存的計費也要等。
- 拿掉 realm 前先確認暫存是空的。 SIGHUP 拿掉某個 realm 時,它還沒送出的計費會移到
rejected.log。看rradius_proxy_acct_spool_bytes是不是 0。 - 和本機計費的暫存分開:
[radius.accounting_spool](第 7 章)管的是寫不進資料庫的計費,兩個目錄不能相同,互不影響。 - 改這個區段要重啟。 檔案含使用者名稱等個人資料,放在持久的磁碟上。
上線前
- 監控:
rradius_proxy_server_alive(0 就告警)、rradius_proxy_acct_spool_bytes(持續大於 0 代表上游還沒恢復)、rradius_proxy_unanswered_total(沒有任何上游回應的請求)。DNS 找到的伺服器也在這些指標裡,server標籤是realm 主機:位址:埠;聯盟很大時時間序列會很多。 - 時間要算好: 每台 UDP 上游最多等
timeout_ms × attempts,RadSec 上游等一次timeout_ms,第一次查某個 realm 還要加上 DNS 的時間。總和要比 NAS 的逾時短。 - 匿名的外層名稱: 使用者的外層名稱通常是
anonymous@uni-b.example。轉送只看 realm,所以沒有影響;但load-balance用外層名稱加 MAC 分配,同一個 realm 的匿名使用者靠 MAC 分開。 - CoA 依 realm 轉給上游時, 只用有名稱的 realm 項目,不用
*,也不用 DNS 找到的伺服器。 - 沒有測過的:
- 依 DNS 找上游,沒有接上真的聯盟。 名稱比對、快取和轉送用模擬的 DNS 測過;查詢本身用公開的 DNS 查過一個 eduroam 成員的記錄。自動測試沒有 DNS,所以這一段不在情境測試裡。
- 暫存的計費在上游恢復後重送, 情境測試只確認了「寫入暫存並回覆 NAS」,重送由專案的其他測試涵蓋。
- 情境測試確認了:本校的 realm 留在本機、
*.gov.example經 RadSec 送到上游、姊妹校依比重分攤、上游全掛時計費有回覆、全國代理經 RadSec 連進來。
常見問題
| 現象 | 原因 |
|---|---|
自己的使用者登入沒有回應,記錄有 came back to this server,或連自己的 2083 埠被關閉 | 自己的 realm 沒有列在 local_realms,被查到自己的伺服器,轉了出去 |
某個 realm 的請求都沒有回應,記錄有 [proxy.discovery]: realm ... 的 WARN | DNS 查詢失敗(不是「沒有」),這個 realm 丟棄 30 秒。檢查這台主機的 DNS 設定(/etc/resolv.conf) |
查到了伺服器,但 cannot connect ... TLS: | 對方的憑證不是 ca_file 簽的;或開了 realm_names_only,而對方的憑證上只有主機名稱 |
| 外校的人第一次登入特別慢 | 第一次查這個 realm 要等 DNS,NAS 的重送在這段時間會被丟棄。之後依 TTL 記住 |
| 外校的人連到一半失敗、重來就好 | load-balance 的一台上游剛停擺或剛恢復,那台的設備換了台 |
rradius_proxy_acct_spool_bytes 一直不降 | 某個 realm 的上游還沒恢復,擋住了整個佇列;看 rradius_proxy_server_alive 是哪一台 |
聯盟的對端連進來被關閉,its certificate fits no client | 沒有 tls_name 符合它憑證的 [[radius.clients]] 項目 |