情境: 分公司的 rradius 服務分公司的 NAS。
- 分公司自己的帳號(
branch1,或branch1@branch.example.com)在本機認證。 - 合作單位的人來訪時用
alice@partner.example.org登入,轉給合作單位的 RADIUS 伺服器,對方有兩台,第一台沒回應時改送第二台。 - 總部的帳號(
@hq.example.com和@eng.hq.example.com這類子網域)轉給總部。
範例目錄:rradius-server/examples/scenarios/realm-proxy/
| 檔案 | 內容 |
|---|---|
rradius.toml | [proxy] 和本地帳號的串接 |
partner.secret、hq.secret | 和上游之間的共用密碼 |
migrations/ | 本地帳號(結構同快速開始)和示範帳號 branch1 |
怎麼決定轉不轉
realm 是 User-Name 最後一個 @ 之後的部分。
alice@partner.example.org ─► 完全相同的 realm "partner.example.org" ─► partner-1,沒回應換 partner-2
bob@eng.hq.example.com ─► "*.hq.example.com" ─────────────────────► hq-1
carol@hq.example.com ─► "hq.example.com" ───────────────────────► hq-1
branch1@branch.example.com ─► 沒有符合的 realm ─────────────────────► 本機的串接
branch1 ─► 沒有 @ ───────────────────────────────► 本機的串接
- 比對順序: 完全相同 → 涵蓋它的
*.項目(最長的優先)→*,不分大小寫。*.hq.example.com不涵蓋hq.example.com本身,所以範例兩個都列。 - 不要隨手加
*。 它會把所有帶@的名稱轉出去,包括branch1@branch.example.com這種自己的帳號。只有「本機沒有帶 realm 的帳號」時才適合用*當預設出口。 - 轉送的請求不在本機處理: 不跑串接、腳本,也不跑 EAP。802.1X 的整段 EAP 對話原樣轉送,金鑰由上游產生。
- 計費也照 realm 轉送, 只有上游回應後才回覆 NAS,不會寫進本機的計費暫存(第 7 章那個只管寫不進資料庫的計費)。要在上游都沒回應時先記下來,用
[proxy.accounting_spool],見第 11 章。
步驟
本機測試需要一台當「合作單位」的伺服器。最簡單的是另開一份快速開始,換個埠:
把整個
quick-start/複製到 repo 以外的地方(例如cp -R examples/scenarios/quick-start /tmp/partner),在/tmp/partner/rradius.toml:dictionary改成 repo 裡share/dictionary的絕對路徑。auth_port = 11812、acct_port = 11813、[metrics] port = 19812。[cluster]加上listen = "127.0.0.1",最後加上[[cluster.nodes]](id = 1、raft = "127.0.0.1:18100"、api = "127.0.0.1:18200"),避開這台的 8100、8200。listen一定要寫: 列了節點之後預設會聽所有介面,而示範的api.secret是公開的。
然後啟動它。
在
realm-proxy/rradius.toml:branch-nas的address改成127.0.0.1。partner-2改成address = "127.0.0.1"、auth_port = 11812、acct_port = 11813,secret_file指向../quick-start/localhost.secret。partner-1保留原本的位址,模擬「第一台沒回應」。
啟動 realm-proxy:
./target/release/rradius-server --config examples/scenarios/realm-proxy/rradius.toml測試:
S=branch-nas-secret-change-me radtest Branch1@branch.example.com branch1-password 127.0.0.1 0 $S # 本機,Filter-Id = branch radtest bob@partner.example.org bob-password 127.0.0.1 0 $S # 轉給 partner,帶回 Welcome, bob第二個會慢幾秒:partner-1 等了
timeout_ms × attempts(3 秒 × 2)沒有回應,被判定停擺,改送 partner-2。之後的請求直接送 partner-2,每 10 秒用 Status-Server 確認一次 partner-1 回來了沒有。radtest第一次可能等不到回應而逾時,再送一次就會成功。
設定說明
[proxy]
timeout_ms = 3000
attempts = 2
check_interval_ms = 10000
[[proxy.servers]]
name = "partner-1"
address = "198.51.100.10"
auth_port = 1812
acct_port = 1813
secret_file = "partner.secret"
[[proxy.realms]]
name = "partner.example.org"
servers = ["partner-1", "partner-2"]
strip_realm = true
servers依序嘗試, 先試沒被判定停擺的。認證和計費的埠分開判定。- 時間要算好: 一台最多等
timeout_ms × attempts。這段時間要比 NAS 的逾時短,否則 NAS 先放棄;timeout_ms又要比上游刻意延遲拒絕的時間長(例如 FreeRADIUS 預設延遲 1 秒才回 Access-Reject),否則錯誤密碼會被當成上游沒回應。 strip_realm = true: 合作單位只認得alice,就去掉@partner.example.org再送。MS-CHAPv2(不經 EAP)的回應是用完整名稱算的,這時要保持false。- 上游的回應要有 Message-Authenticator(
require_message_authenticator = true,預設)。舊的上游不送時才設false,不建議。 - 都沒回應時不回覆 NAS。 回 Access-Reject 會讓使用者以為密碼錯,所以讓 NAS 自己逾時、改用它的備援。
- 停擺的上游怎麼回來: 每
check_interval_ms用 Status-Server 問一次,有回應就恢復。上游不會回答 Status-Server 時,在那台設status_check = false,時間到就直接當成恢復,由下一個請求判斷。 - 提早發現停擺(
probe_interval_ms): 預設只有真的請求逾時,才會判定一台上游停擺,所以它掛掉後的第一批請求都要先等。在[[proxy.servers]]設probe_interval_ms = 30000之後,這台超過 30 秒沒有任何回應就主動送 Status-Server,連續 3 次沒回應判定停擺。備援機平常沒有流量,特別需要它。見第 11 章。
本地帳號
[auth.username]
strip_realm = "suffix"
lowercase = true
Branch1@branch.example.com 沒有符合任何 realm,留在本機,查帳號時變成 branch1。
跨組織漫遊:RadSec 上游
合作單位在別的組織、中間經過網際網路時,不要用 UDP 轉送,改用 RadSec(RADIUS over TLS):整個封包都在 TLS 裡,雙方用憑證確認彼此。
準備憑證。 向對方(或漫遊聯盟)拿到簽發對方伺服器憑證的 CA,存成
partner-ca.pem。對方要驗證 rradius 時,再準備一張由對方信任的 CA 簽發的憑證和私鑰(our-cert.pem、our-cert.key)。問清楚對方伺服器憑證上的名稱,例如radius.partner.example.org。改上游的設定。 把
partner-1換成 RadSec:[[proxy.servers]] name = "partner-1" address = "198.51.100.10" transport = "tls" tls_name = "radius.partner.example.org" ca_file = "partner-ca.pem" cert_file = "our-cert.pem" key_file = "our-cert.key"- 不設
port就是 2083,認證和計費都走這個埠,不能再寫auth_port、acct_port。 - 不用設
secret:RadSec 的共用密碼固定是radsec(RFC 6614),對方也是這樣設。對方另外指定時才寫secret或secret_file。 - realm 的
servers可以混用 RadSec 和 UDP 上游,照樣依序容錯。
- 不設
檢查並啟動:
./target/release/rradius-server --check --config examples/scenarios/realm-proxy/rradius.toml憑證檔讀不到、私鑰和憑證不配對、少了
tls_name或ca_file,這一步就會指出是哪台上游、哪個欄位。確認: 送一個轉給對方的登入。log 會出現
proxy server partner-1: connected to 198.51.100.10:2083,/metrics的rradius_proxy_connections_total{server="partner-1",result="connected"}是 1。之後的請求都走同一條連線,不會每次重新握手。
和 UDP 上游不同的地方:
- 不重送。 TCP 保證送達,一個請求只送一次,
attempts不適用;timeout_ms內沒有回應就換下一台。一台最多等一次timeout_ms。 - 認證和計費一起判定停擺, 因為只有一個埠、一條連線。
- 一條連線最多同時 256 個請求等回應, 再多的排隊。對方很遠又很忙時,這會是上限(往返 10 ms 約每秒 2.5 萬個請求,估計值)。在同一台機器上量,一條連線約每秒 10 萬個請求,比 UDP 上游少一成左右,見 usage 2.13 節。
- CoA 也走這條連線: 依 realm 轉給 RadSec 上游的 Disconnect 和 CoA,在同一條連線上送。對方要願意在這條連線上收,先向對方確認。
- 撤銷清單(
crl_file)只在啟動和 SIGHUP 時讀, 對方換了清單要 SIGHUP。
上線前
- UDP 上游要在可信任的網路上(專線、VPN),因為 RADIUS 的 UDP 只加密密碼。要經過網際網路就用 RadSec 上游(見上一節)。
- 上游位址只能寫 IP, 不能寫主機名稱。
- 和 UDP 上游的共用密碼 每個單位不同,要夠長。
- 迴圈: 兩台互相轉送時,rradius 看到自己的 Proxy-State 就丟棄並記錄。
- 監控: 每台上游的請求數、逾時和停擺狀態都在
/metrics,見 usage 2.8 節。 - 重新載入(SIGHUP) 會套用
[proxy]的變更,所有上游重新當成正常。 - CoA 也能依 realm 轉給上游: 本機找不到 NAS、而
User-Name的 realm 符合某個項目時,Disconnect 和 CoA 請求會轉給那個 realm 的上游(送到上游的coa_port,預設 3799),見 usage 4.8 節。 - 目前沒有的: 輪流分配、由腳本決定路由、DTLS、TLS-PSK。見 usage 2.13 節。
更多做法
這一章是最基本的「依序容錯」。以下幾樣在第 11 章用一個漫遊聯盟的情境說明:
| 需要 | 做法 |
|---|---|
| 把請求分攤到多台上游,可以設比重 | balance = "load-balance"、weight |
| 上游太多、無法一一設定 | [proxy.discovery]:依 realm 查 DNS 找出對方的 RadSec 伺服器 |
| 上游都沒回應時,轉送的計費不能遺失 | [proxy.accounting_spool] |
| 對方也要把請求送進來 | [radius.tls],見第 10 章 |
常見問題
| 現象 | 原因 |
|---|---|
| 帶 realm 的本地帳號被轉出去 | 有 * 或涵蓋自己網域的 *. 項目 |
| 轉送的登入每次都很慢 | 第一台上游一直沒回應,但 Status-Server 確認時又有回應(上游回 Status-Server 但不處理認證),可以把它從 servers 拿掉,或設 status_check = false |
| 錯誤密碼的登入之後,上游被判定停擺 | timeout_ms 比上游延遲拒絕的時間短 |
RadSec 上游一直連不上,log 有 cannot connect ... TLS: | 對方憑證不是 ca_file 的 CA 簽的、對 tls_name 無效,或對方不接受 rradius 出示的憑證(沒設 cert_file、或不是對方信任的 CA 簽的)。log 的訊息會說是哪一種 |
| RadSec 上游連上了但每個請求都逾時 | 共用密碼不是 radsec,對方的回應驗證不過:問對方用的密碼,設在 secret |