9. 依 realm 轉送

情境: 分公司的 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 章。

步驟

本機測試需要一台當「合作單位」的伺服器。最簡單的是另開一份快速開始,換個埠:

  1. 把整個 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 是公開的。

    然後啟動它。

  2. 在 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 保留原本的位址,模擬「第一台沒回應」。
  3. 啟動 realm-proxy:

    ./target/release/rradius-server --config examples/scenarios/realm-proxy/rradius.toml
    
  4. 測試:

    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 裡,雙方用憑證確認彼此。

  1. 準備憑證。 向對方(或漫遊聯盟)拿到簽發對方伺服器憑證的 CA,存成 partner-ca.pem。對方要驗證 rradius 時,再準備一張由對方信任的 CA 簽發的憑證和私鑰(our-cert.pem、our-cert.key)。問清楚對方伺服器憑證上的名稱,例如 radius.partner.example.org。

  2. 改上游的設定。 把 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 上游,照樣依序容錯。
  3. 檢查並啟動:

    ./target/release/rradius-server --check --config examples/scenarios/realm-proxy/rradius.toml
    

    憑證檔讀不到、私鑰和憑證不配對、少了 tls_name 或 ca_file,這一步就會指出是哪台上游、哪個欄位。

  4. 確認: 送一個轉給對方的登入。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
使用 Hugo 建立
主題 Stack 由 Jimmy 設計