14. 幾百台分店的 NAS:動態 client

情境: 連鎖門市有幾百家分店,每家有一兩台 AP 或閘道,每個月都有新店開張、舊店換設備。照前面幾章的做法,每台 NAS 都要在設定檔寫一個 [[radius.clients]],每次異動都要改每個節點的設定檔再重新載入。

改成把 NAS 寫在資料表裡:

  • 來源不在設定檔裡的請求,rradius 依來源位址查資料表,查到就用查到的名稱和共用密碼處理。
  • 新增一台只要執行一次 rradius-server client add,寫進資料表後整個叢集都看得到,不必改設定檔,也不必重啟。
  • 每台 NAS 可以有自己的共用密碼。

什麼時候不需要: NAS 只有十幾台、很少變動,寫在設定檔就好。NAS 用 RadSec 時也不需要,它本來就能只靠憑證辨認(第 10 章)。

範例目錄:rradius-server/examples/scenarios/branch-nas/

檔案內容
rradius.toml[radius.dynamic_clients]、client 指令用的 [accounts.clients]
migrations/1_schema.sqlnas(分店的 NAS)、帳號和計費(同快速開始)
migrations/2_demo_data.sql一個示範帳號 clerk1、一台示範的 NAS

一個封包怎麼被認出來

來源位址
  ├─ 符合某個 [[radius.clients]] ─────────────────► 用設定檔的(永遠優先)
  ├─ 不在 networks 的網段裡 ──────────────────────► 丟棄,不回應
  └─ 在 networks 裡
       ├─ 記得這個位址(查到過,還沒過期)─────────► 用記住的名稱和密碼
       ├─ 記得「查不到」(還沒過期)────────────────► 丟棄
       └─ 都沒有 → 查資料表
            ├─ 查到 ─► 記住 lifetime_ms,處理這個封包
            ├─ 查不到 ─► 記住 negative_lifetime_ms,丟棄
            └─ 資料庫出錯或太慢 ─► 丟棄,不記住,下一個封包再查

步驟

1. 啟動

cd rradius-server
./target/release/rradius-server --config examples/scenarios/branch-nas/rradius.toml

2. 加一台 NAS

printf '%s\n' 'store-0107-secret-change-me' \
  | ./target/release/rradius-server client add --config examples/scenarios/branch-nas/rradius.toml \
      --name store-0107-ap1 10.20.1.7
# added client 10.20.1.7

這一列已經寫進整個叢集。之後 10.20.1.7 用這把共用密碼送來的請求就會被處理,名稱是 store-0107-ap1。

範例的 networks 是 10.20.0.0/16,本機測試時請求只能從 127.0.0.1 送出,所以在本機要看到動態查詢,先把 networks 改成 ["127.0.0.0/8"],再 client add --name test-ap 127.0.0.1,用那把共用密碼從本機送請求。自動測試就是這樣做的。

3. 確認

curl -s http://127.0.0.1:9812/metrics | grep rradius_dynamic_client
  • rradius_dynamic_client_lookups_total{result="found"}:查到的次數。一台 NAS 在 lifetime_ms 內只查一次。
  • rradius_dynamic_clients:目前記住幾台。

設定說明

[radius.dynamic_clients]
networks = ["10.20.0.0/16"]
query = "SELECT name, secret FROM nas WHERE address = ?"
lifetime_ms = 300000
negative_lifetime_ms = 60000
max_clients = 10000
  • networks(必填): 只有這些網段裡的來源才會查。設得越精確越好: 網段裡任何位址送來一個封包,都會觸發一次資料庫查詢。
  • query(必填): 一個 ?,代入來源位址的文字(10.20.1.5)。第一欄是名稱,第二欄是共用密碼。
    • 名稱是空的就用來源位址當名稱。
    • 密碼是空的,或名稱和設定檔裡某個 client 相同時,當作查不到,並記錄一行。
  • lifetime_ms: 查到的記住多久(預設 5 分鐘)。這段時間內改了資料表,這個節點還是用舊的。
  • negative_lifetime_ms: 查不到的記住多久(預設 1 分鐘),這段時間不再查,避免被陌生來源一直觸發查詢。
  • max_clients: 最多記住幾台。滿了先清掉過期的,再清掉「查不到」的。
  • 查詢的時限 是 [lua] query_timeout_ms。範例設成 2 秒。

新 NAS 的第一個請求

一個來源正在查的時候,它的封包直接丟棄;同時查詢超過 16 個時也丟棄。所以新 NAS 的第一個請求通常要靠一次重送才有回應,之後就和設定檔裡的 client 一樣快。這是正常的,rradius_dynamic_client_lookups_total{result="busy"} 會計數。

動態 client 和設定檔裡的 client 有什麼不同

設定檔裡的動態的
認證串接可以用 auth 指定一律用預設串接
EAP 方法可以用 eap_methods 指定伺服器的全部方法
Message-Authenticator 的設定每個 client 可以覆寫用 [radius] 的設定
當 CoA 的目標(send_coa、CoA 轉送)可以不行
RadSec可以不行,只有 UDP
每個 client 的指標有沒有,只有上面兩個總數

要對某幾台 NAS 送 CoA,或讓它們用別的串接,那幾台就寫在設定檔裡。設定檔裡的永遠優先。

加一台、改一台、移除一台

用 client 指令

# 加一台:共用密碼從標準輸入讀,不放在命令列
printf '%s\n' '<這台的共用密碼>' | rradius-server client add --config rradius.toml --name store-0405-ap1 10.20.4.5

# 換共用密碼
printf '%s\n' '<新的共用密碼>' | rradius-server client secret --config rradius.toml 10.20.4.5

# 查看、移除
rradius-server client show --config rradius.toml 10.20.4.5
rradius-server client delete --config rradius.toml 10.20.4.5

每個動作執行哪一條 SQL 寫在 [accounts.clients],資料表結構由你決定:

[accounts.clients]
add = "INSERT INTO nas (address, name, secret) VALUES (?1, ?2, ?3)"
secret = "UPDATE nas SET secret = ?2 WHERE address = ?1"
delete = "DELETE FROM nas WHERE address = ?1"
show = "SELECT address, name FROM nas WHERE address = ?1"
  • ?1 是位址;add 的 ?2 是名稱、?3 是共用密碼;secret 的 ?2 是新的共用密碼。 完整規則見參考文件 2.14 節。
  • 送出之前先檢查, 錯了什麼都不寫、以狀態 2 結束:位址要是一個 IP(不是網段),要落在 networks 裡,不能落在設定檔任何 client 的位址或網段裡(那樣永遠不會查表);名稱不能和設定檔的 client 相同(伺服器會當成查不到)。
  • 共用密碼短於 16 個字元時會警告, 但照樣寫入,和設定檔裡的 client 相同。
  • 寫入經過叢集, 在任何一個節點上執行都可以。指令用 [cluster] 的 secret_api 連線,所以設定檔只讓管理者讀得到。
  • 結果: added client 10.20.4.5、secret changed for client 10.20.4.5、deleted client 10.20.4.5,狀態 0;沒有這一列時印 no client 10.20.4.5,狀態 1;已經有這個位址或名稱時資料庫拒絕,狀態 1。

用 migration 檔

-- 3_new_stores.sql
INSERT INTO nas (address, name, secret) VALUES
  ('10.20.4.5', 'store-0405-ap1', '<這台的共用密碼>'),
  ('10.20.4.6', 'store-0405-ap2', '<這台的共用密碼>');

放到每個節點,逐台重啟(第 8 章)。適合第一次匯入一大批、想把清單留在版本控制裡的情況;之後的異動用 client 指令。

改了之後多久生效

動作這個節點什麼時候看到
加一台新的它的下一個封包(之前沒查過);之前查過而「查不到」的,最多等 negative_lifetime_ms
換共用密碼最多等 lifetime_ms。期間 NAS 用新密碼送的封包驗證不過,沒有回應
移除一台最多等 lifetime_ms,期間它還是能用

client 指令只改資料表,不會通知節點,所以上表照樣適用。要立刻生效,對每個節點送 SIGHUP: 重新載入時記住的內容全部清空。換密碼和移除通常要這樣做。

上線前

  • 共用密碼是明文存在資料表裡。 讀得到資料庫的人和 [lua] 的腳本都看得到。控管資料目錄、備份和腳本的權限。
  • 來源位址可以偽造。 UDP 的來源位址不可靠,共用密碼和 Message-Authenticator 才是驗證。範例維持 [radius] 預設的 require_message_authenticator = "yes",這個設定也套用在動態 client 上。
  • 掃描的代價: 有人從網段裡的大量位址(或偽造的來源)送封包時,每個位址觸發一次查詢、記一筆「查不到」。同時查詢的上限(16)和 negative_lifetime_ms 限制了負擔,但 networks 還是越小越好,並用防火牆只放行真的有 NAS 的網段。
  • 資料庫出問題時: 已經記住的 NAS 照常服務到 lifetime_ms 到期;到期後查不了,封包丟棄(計入 result="failed"),不會被記成「查不到」。查詢讀的是本機副本,依設計不需要叢集的多數節點(這個情況沒有專門測過)。
  • 計費暫存: 動態 client 的計費進了暫存(第 7 章)之後,重放時會依當時的來源位址重查,名稱相同才處理。所以不要在暫存還有資料時改 NAS 的名稱,否則那些計費會被移到 rejected.log。
  • 計費資料表的 client 欄 是資料表裡的名稱,所以名稱要唯一、定了就不要改。範例的 nas.name 有 UNIQUE。
  • 監控: rradius_dynamic_client_lookups_total{result="not_found"} 突然增加,代表有沒登記的設備在送請求,或有人在掃描;result="failed" 增加代表資料庫有問題。
  • 沒有測過的: 實體 NAS。情境測試在本機確認了 client add 後登入和計費、client secret 之後節點沿用記住的密碼直到 SIGHUP、client delete 加 SIGHUP 後不再回應。

常見問題

現象原因
新 NAS 完全沒有回應來源不在 networks 裡;資料表的 address 和 rradius 看到的來源不同(NAT、多個介面);或剛才查不到,還在 negative_lifetime_ms 內
新 NAS 的第一個請求沒回應,重送就好了正常:查詢期間的封包會丟棄
記錄說名稱和設定檔裡的 client 相同資料表的 name 不能和任何 [[radius.clients]] 的 name 相同
換了密碼後這台 NAS 不通節點還記著舊密碼,送 SIGHUP 或等 lifetime_ms
移除後還能用同上
動態 client 的 EAP 提供了不該有的方法動態 client 不能設 eap_methods,會用伺服器的全部方法。要限制就把那台寫進設定檔
rradius_radius_discarded_total{reason="invalid"} 增加資料表裡的共用密碼和 NAS 上的不同
使用 Hugo 建立
主題 Stack 由 Jimmy 設計