11. 漫遊聯盟(eduroam 這一類)

情境: 一所學校(範例的 realm 是 uni-a.example)加入漫遊聯盟。聯盟的成員互相承認帳號:任何成員的使用者到了別的成員那裡,都能用自己學校的帳號連上 Wi-Fi。

  • 本校的人在本校: [email protected] 在本機認證。
  • 外校的人來訪: [email protected] 轉給他自己的學校。成員太多,無法一一設定,所以依 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                    沒有 @ ─────────────────────────────► 本機
[email protected]      在 local_realms ────────────────────► 本機
[email protected]           [[proxy.realms]] 完全相同 ──────────► uni-b-1、uni-b-2(分攤)
[email protected]      [[proxy.realms]] 的 *.gov.example ──► 全國代理
[email protected]          沒有項目 → 查 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 [email protected] student1-password 127.0.0.1 0 campus-wlc-secret-change-me

會收到 Access-Accept,帶 Filter-Id = "campus"。

2. 正式環境要換掉的

  1. 向聯盟申請 RadSec 憑證, 並拿到聯盟的 CA。取代 certs/radius.pem、certs/radius.key、certs/federation-ca.pem。
  2. local_realms、[[radius.clients]] 的全國代理名稱、flr-1/flr-2 的位址和 tls_name 換成聯盟給的值。
  3. [radius.eap] 的憑證 換成你要給自己的使用者看的那一張,見第 3 章。
  4. 在 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),它們的位址換了也不用改設定。進來的請求名稱是 [email protected],在 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 重送幾次後就遺失。設定後:

  1. realm 的每台上游都沒有回應時,請求先寫到本機的 dir,落盤後回覆 NAS。
  2. 背景工作從最舊的開始再送,一次最多同時送 replay_window 筆,Acct-Delay-Time 會加上等待的時間。上游還是沒回應時,隔 replay_interval_ms 再試。
  3. 上游回應後,這一筆才算完成。
  • 只暫存計費。 登入要即時的答案,上游沒回應時不回覆,讓 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 的逾時短。
  • 匿名的外層名稱: 使用者的外層名稱通常是 [email protected]。轉送只看 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 ... 的 WARNDNS 查詢失敗(不是「沒有」),這個 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]] 項目
使用 Hugo 建立
主題 Stack 由 Jimmy 設計