7. 寬頻業者(PPPoE/IPoE)

情境: 地區寬頻業者,用戶透過 BNG(寬頻接取閘道)撥接 PPPoE 或 IPoE 上網。

  • 每個用戶有一個方案:方案決定速率和同時上線數(家用 1 個,企業 4 個)。
  • 欠費的用戶停權,不能再登入。
  • 計費記下每個 session 的時間、流量和配到的 IP。
  • 帳務系統停權時要立刻把人踢下線,但它不知道用戶在哪台 BNG、session ID 是什麼,也沒有 BNG 的共用密碼。
  • 資料庫短暫出問題時,計費不能遺失。

範例目錄:rradius-server/examples/scenarios/broadband/

檔案內容
rradius.tomlall_accept 串接、CoA 轉送、計費暫存
accounting.lua計費:每個 session 一列,記下 NAS 和 IP
session-limit.lua同時上線數的檢查
migrations/1_schema.sqlplans、plan_reply、subscribers、accounting
migrations/2_demo_data.sql兩個方案、三個用戶(一個停權)

流程

登入:BNG ──► sql 處理器(密碼、方案屬性)──► session-limit.lua(還有名額嗎)──► Accept + 速率
計費:BNG ──► accounting.lua ──► accounting 表
踢人:帳務系統 ──Disconnect-Request(只有 User-Name)──► rradius
        rradius 用 session_query 查 accounting 表 ──► 找到的每個 session 轉給它的 BNG

同時上線數和踢人都讀同一張 accounting 表,所以只要計費正確,兩個功能就正確。

步驟

1. 改 client 並啟動

本機測試時,把 bng-1 的 address 和 billing 的 address 都改成 127.0.0.1,bng-1 的 coa_port 改成 3800(否則轉給 BNG 的請求會送回 rradius 自己的 3799 埠)。

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

2. 登入和同時上線數

S=bng-shared-secret-change-me
radtest home0001 home0001-password 127.0.0.1 0 $S
# Access-Accept:Mikrotik-Rate-Limit = "100M/100M"、Acct-Interim-Interval = 300

echo 'User-Name=home0001,Acct-Session-Id=bb-1,Acct-Status-Type=Start,Framed-IP-Address=100.64.0.9' \
  | radclient 127.0.0.1:1813 acct $S

radtest home0001 home0001-password 127.0.0.1 0 $S
# Access-Reject:家用方案只能一個 session,記錄有 too many sessions

radtest home0002 ... 一律被拒絕,它的 status 是 suspended。

3. 帳務系統踢人

帳務系統只送 User-Name,用自己的共用密碼簽章,送到 rradius 的 3799 埠:

echo 'User-Name=home0001' | radclient 127.0.0.1:3799 disconnect billing-coa-secret-change-me

rradius 查出 home0001 還開著的 session(bb-1,在 bng-1),把 Disconnect-Request 加上 Acct-Session-Id = bb-1 轉給 bng-1 的 coa_port,再把 BNG 的回答傳回帳務系統。本機沒有真的 BNG 在 3800 埠回答,所以重試完(預設 1 秒 × 3 次)後收到 NAK,Error-Cause 是 505;對沒有 session 的用戶送,會收到 NAK 503(Session Context Not Found)。

設定說明

先比對密碼,再檢查名額

[auth]
policy = "all_accept"

[[auth.handlers]]
type = "sql"
user_query = "SELECT password FROM subscribers WHERE username = ? AND status = 'active'"
reply_query = "SELECT r.attribute, r.value FROM subscribers s JOIN plan_reply r ON r.plan = s.plan WHERE s.username = ?"

[[auth.handlers]]
type = "lua"
script = "session-limit.lua"
  • all_accept: 每個處理器都要接受。sql 拒絕(密碼錯、停權)就不會跑腳本;sql 接受後腳本才檢查名額。
  • 不要用 first_match: 那樣 sql 查不到名稱時會交給腳本,腳本只檢查名額,不存在的帳號就不用密碼通過了。
  • reply_query 依方案回屬性。 範例用 MikroTik 的 Mikrotik-Rate-Limit;其他廠商的 BNG 用各自的屬性,例如 Cisco 的 Cisco-AVPair、Juniper 的 ERX-*,在 plan_reply 換成你的 BNG 認得的名稱和值。
  • Acct-Interim-Interval = 300 要求 BNG 每 5 分鐘回報一次。session-limit.lua 的 STALE_AFTER 和 [radius.coa] 的 session_query 都把超過 900 秒沒回報的 session 當成已經離線(BNG 當機不會送 Stop),所以這個間隔一定要比 900 秒短。要改 900 秒時,兩個地方一起改。
[auth.username]
lowercase = true
allowed = "[a-z0-9._@-]+"

HOME0001 和 home0001 是同一個人,否則各算各的名額。accounting.lua 也把名稱轉小寫。

session-limit.lua

SELECT p.max_sessions AS allowed,
       (SELECT count(*) FROM accounting a
        WHERE a.username = s.username AND a.stopped IS NULL AND a.updated > ?) AS online
FROM subscribers s JOIN plans p ON p.name = s.plan
WHERE s.username = ?
  • 名額從 Accounting-Start 才算。兩個同時進來的登入可能都通過, 這是所有「看計費算名額」做法的共同限制。
  • 叢集裡讀的是本機副本,可能比剛寫入的計費慢一點。
  • auth_user 是串接正規化後的名稱(小寫)。

accounting.lua

和快速開始的相同(Start、Interim、Stop 寫進同一列,可以重複執行,NAS 重開機時結束它的 session),另外:

  • nas 欄: 送 CoA 要去的地方,取 NAS 回報的 NAS-IP-Address 或 NAS-IPv6-Address,都沒有時用 client 名稱。
  • framed_ip 欄: 配給用戶的 IP,後來的 Interim-Update 沒帶時保留原值。客服查「這個 IP 剛才是誰」時用得到。

CoA 轉送

[radius.coa]
port = 3799
session_query = "SELECT nas, session_id FROM accounting WHERE username = ? AND stopped IS NULL AND updated > strftime('%s', 'now') - 900 ORDER BY updated DESC"

[[radius.coa.clients]]
name = "billing"
address = "10.20.0.5"
secret_file = "billing.secret"
  • [[radius.coa.clients]] 是可以要求踢人的系統, 和 NAS 的名單分開。
  • 請求有指定 NAS(NAS-IP-Address 等)時直接轉給那台, 只有 User-Name 時才用 session_query 查。查詢只有一個 ?,代入 User-Name,所以帳務系統沒辦法注入 SQL。
  • 回覆: 任一台 BNG 回 ACK 就回 ACK;全部拒絕時傳回其中一個 NAK;查不到 session 回 NAK 503;查到的 NAS 都不是設定的 client 回 502;查詢失敗或 BNG 都沒回應回 505。一個用戶最多轉給 32 個 session。
  • BNG 要開 CoA(RFC 5176), 接受 rradius 的來源位址,埠是 client 的 coa_port(預設 3799,有些設備用 1700)。
  • 只有 User-Name 的請求在多台 BNG 時很方便, 但查詢依賴計費:BNG 沒送 Start,就查不到。
  • 想自己從腳本或命令列踢人,見 usage 4.8 節的 send_disconnect 和 rradius-server disconnect 指令。

計費暫存

[radius.accounting_spool]
dir = "spool"

資料庫寫不進去(叢集失去多數節點、逾時)時,計費先寫到本機目錄並回覆 BNG,恢復後由 accounting.lua 重放。腳本可以重複執行,所以重放不會重複計算。暫存檔含個人資料,目錄權限是 0700;磁碟壞掉時還沒重放的就遺失了。見 usage 2.11 節。

  • 只暫存資料庫造成的失敗。 腳本自己的錯誤、回傳 'reject' 都不暫存,和沒有這個區段時一樣不回覆,錯誤不會被藏起來。
  • 重放時腳本看得出來: 全域變數 replayed 是 true,Acct-Delay-Time 已經加上待在暫存裡的時間。
  • 恢復前,依賴計費的功能看不到這些資料: 同時上線數和踢人都讀 accounting 表。rradius_acct_spool_bytes 大於 0 就代表有落後,拿它告警。
  • query_timeout_ms 決定多久才進暫存。 叢集沒有多數節點時,寫入要等到 [lua] query_timeout_ms(預設 5 秒)才算失敗,這段時間 BNG 收不到回覆。比 BNG 的重送間隔長時調低它。
  • 重放的速度(replay_window): 預設一次重放一筆、依寫入順序,每秒約幾千筆。停機很久、累積很多時可以設 replay_window = 8 同時重放;但同一個 session 的 Start、Interim、Stop 可能同時執行或順序顛倒。範例的 accounting.lua 把三種寫進同一列、數字取較大的值,順序顛倒也沒關係;你的腳本靠先後順序時維持 1。
  • 重放卡住時: rejected.log、.corrupt 檔怎麼看,見第 20 章。

上線前

  • 方案和用戶的資料從哪裡來? 範例的示範用戶來自 migration 檔。範例設定已有 [accounts],可以用 rradius-server user add|passwd|disable 管理用戶(停用就是把 status 改成 suspended);帳務系統也可以呼叫這些指令同步,見第 19 章。
  • IP 位址池: 範例由 BNG 自己配發。要由 RADIUS 配發時參考 examples/ip-pool.lua,它在整個叢集內保證同一個位址不會同時給兩個人。
  • 時間配額和可上網時段: 參考 examples/quota-and-hours.lua。
  • accounting 表會一直變大, 清除舊資料見第 19 章。
  • 多台 BNG、多台 rradius 時,見第 8 章。每台 BNG 都要能收到每個 rradius 節點送的 CoA。
  • BNG 在 NAT 後面、或中間是不信任的網路時, BNG 用 RadSec 連進來,踢人的請求走它自己開的那條連線,見第 10 章。
  • 用戶資料在帳務系統裡、不想複製一份時, 可以每次登入問帳務系統的 API,見第 18 章。

常見問題

現象原因
用戶下線了還是被說「太多 session」BNG 沒送 Stop(當機、斷線),要等 900 秒;或 BNG 重開機時沒送 Accounting-On
踢人回 503查不到開著的 session:BNG 沒送計費、名稱大小寫不同、超過 900 秒沒回報
踢人回 505BNG 沒回應:沒開 CoA、埠不對、不接受 rradius 的來源位址、共用密碼不同
踢人的請求沒有任何回應送出端不在 [[radius.coa.clients]],或密碼不對,計入 rradius_coa_relay_discarded_total
使用 Hugo 建立
主題 Stack 由 Jimmy 設計