rradius 做什麼
rradius 是 AAA 伺服器:網路設備(NAS:無線控制器、交換器、VPN 閘道、BNG、路由器)在有人要上網或登入時來問它三件事:
- 認證(Authentication):這個人是誰,密碼或憑證對不對。
- 授權(Authorization):通過之後給他什麼,例如 VLAN、速率、權限等級、能下哪些指令。
- 計費(Accounting):他什麼時候上線、下線,用了多少流量。
設備和 rradius 之間用兩種協定:
| 協定 | 用在哪裡 | 埠 |
|---|---|---|
| RADIUS(UDP) | 使用者上網:Wi-Fi、有線 802.1X、VPN、PPPoE | 認證 1812、計費 1813 |
| RadSec(RADIUS over TLS) | 要經過不信任網路的 RADIUS(第 10 章) | 2083 |
| TACACS+(TCP) | 管理員登入網路設備(第 6 章) | 49 |
| TACACS+ over TLS | 同上,整條連線放進 TLS 1.3(第 16 章) | 300 |
另外,其他系統可以把「踢人」「改權限」的請求(Disconnect、CoA)送到 3799 埠,由 rradius 轉給 NAS(第 7、10 章)。
一個請求怎麼被處理
NAS ──Access-Request──► rradius
│
├─ 來源不是設定的 client ─────────► 丟棄,不回應
│ (有 [radius.dynamic_clients] 而且來源在它的網段裡:先查資料表,第 14 章)
├─ Status-Server ─────────────────► 直接回答(status_server = true 時)
├─ 名稱的 realm 符合 [proxy] ──────► 轉給上游,回應原樣帶回(第 9、11 章)
├─ 帶 EAP-Message ────────────────► EAP(TLS、PEAP、TTLS、AKA')完成後
│ 把名稱交給下面的串接(第 3、13、15 章)
├─ 帶 Wi-Fi 四次交握的內容 ───────► [radius.dpsk] 找出是誰的密碼,
│ 再把那個人交給下面的串接(第 12 章)
├─ client 有 auth = "名稱" ───────► 那條具名串接
├─ 有 [[auth.handlers]] ──────────► 預設串接
└─ 都沒有 ────────────────────────► [lua].script
- 認證串接(
[auth]) 把幾個處理器(sql、ldap、lua)依序執行。first_match由第一個有意見的處理器決定;all_accept要每個處理器都同意,常用來「先比對密碼,再檢查政策」。見 usage 第 3 節。 - 最上層腳本(
[lua].script) 一定要有。它處理所有計費和 TACACS+ 的授權,也處理沒有串接的認證。所以有串接的情境,最上層腳本通常只寫計費。 - 計費(Accounting-Request) 不經過串接,一律交給最上層腳本;名稱符合
[proxy]時轉給上游。 - RadSec 進來的請求走同一條路。 差別只在怎麼認得 NAS(憑證)和封包怎麼保護(TLS)。
- 不回應是刻意的。 來源不認得、簽章不對、太忙、上游沒回應時,rradius 都不回應,讓 NAS 重送或改用備援。「沒有回應」怎麼查,見第 20 章。
設定檔的結構
一個設定檔就是一台伺服器。常見的區段:
| 區段 | 內容 | 必要 |
|---|---|---|
dictionary | RADIUS 字典檔,repo 的 share/dictionary | 是 |
[lua] | 最上層腳本和腳本的時限 | 是 |
[cluster] | 資料目錄、叢集密碼、節點、migration | 是 |
[auth] | 認證串接 | 否 |
[radius]、[[radius.clients]] | RADIUS 的埠和可以來問的設備 | 用 RADIUS 時 |
[radius.tls] | RadSec(第 10 章) | 否 |
[radius.eap] | 802.1X 用的 EAP 和憑證(第 3、13、15 章) | 用 EAP 時 |
[radius.dpsk] | 每人一把 Wi-Fi 密碼(第 12 章) | 否 |
[radius.dynamic_clients] | 從資料表查 NAS(第 14 章) | 否 |
[radius.coa] | 接收其他系統送來的斷線請求(第 7、10 章) | 否 |
[radius.accounting_spool] | 資料庫寫不進去時暫存計費(第 7 章) | 否 |
[tacacs]、[[tacacs.clients]] | TACACS+(第 6 章) | 用 TACACS+ 時 |
[tacacs.tls] | TACACS+ over TLS(第 16 章) | 否 |
[proxy] | 依 realm 轉送(第 9、11 章) | 否 |
[lua.http] | 讓腳本呼叫 HTTP API(第 18 章) | 否 |
[accounts] | rradius-server user 指令執行的 SQL(第 19 章) | 否 |
[metrics] | Prometheus 指標 | 否 |
[log] | 記錄格式、等級、追蹤特定使用者 | 否 |
[radius] 和 [tacacs] 至少要有一個。每個區段都拒絕不認得的欄位,所以欄位拼錯時啟動就會失敗並指出名稱。
相對路徑以設定檔所在目錄為準, 和從哪裡啟動無關。
密碼一律放檔案(
secret_file),不要寫在設定檔裡。檔案結尾的換行會去掉。金鑰檔的權限會被檢查。 保護資料表內容的金鑰(
aka.key、dpsk.key、ticket.seal)只能是 0600、0640、0400 這類權限,別人讀得到就拒絕啟動。它們不在 repo 裡,由各情境的setup.sh產生。設定錯誤在啟動時就失敗(狀態碼 2),訊息會指出欄位。上線前用
--check檢查:rradius-server --check --config /etc/rradius/rradius.toml它檢查設定、字典、憑證、migration 檔名和腳本語法,但不連資料庫和 LDAP,所以 SQL 寫錯、LDAP 密碼錯誤要啟動後才知道。
client:誰可以來問
[[radius.clients]] 列出可以送請求的設備,每個有位址(單一 IP 或網段)和共用密碼。
[[radius.clients]]
name = "wlc" # 記錄、指標和腳本裡的 client 都用這個名稱
address = "10.30.0.10" # 或 "10.30.0.0/24"
secret_file = "wlc.secret"
- 不在名單裡的來源完全不回應。 這是新手最常遇到的「伺服器沒反應」,看記錄裡的
unknown client。 - 最長前綴優先: 同時有
10.0.0.0/8和10.30.0.10時,後者比較精確,用後者。 - 共用密碼要夠長, 少於 16 個字元會有警告,建議 24 個以上的隨機字元。每台設備可以不同。
- 預設要求 Message-Authenticator。 舊設備不送時會被丟棄,要在那個 client 設
require_message_authenticator = "no"或"auto",見 usage 2.6 節。 - NAS 很多又常變動時, 可以不寫在設定檔,改放資料表(第 14 章)。
- NAS 用 RadSec 時, 可以只靠憑證辨認,不必有固定位址(第 10 章)。
資料表和 migration
rradius 內建資料庫(hiqlite:SQLite 加上 Raft 複寫),單機和叢集用法相同。帳號、回覆屬性、計費這些資料表由你自己定義,寫成 SQL 檔放在 migrations_dir,啟動時依編號套用:
migrations/
1_schema.sql 建立資料表
2_demo_users.sql 示範資料
檔名是
<編號>_<名稱>.sql, 編號從 1 開始連續。套用過的檔案不能改, 改了會啟動失敗。要改結構或加資料,就新增下一個編號的檔案,再重新啟動(叢集要逐台重啟)。見 usage 2.5 節。
腳本讀寫資料:
sql_query讀本機副本,sql_execute寫入並複寫到所有節點。來自請求的值一律用參數傳,不要接進 SQL 字串:local rows = sql_query("SELECT plan FROM subscribers WHERE username = ?", {get_attr('User-Name')})
帳號的新增、改密碼和停用不必寫 migration:設定 [accounts] 後用 rradius-server user 指令,整個叢集立刻生效,見第 19 章。
計費要能重複執行
NAS 沒收到 Accounting-Response 會重送,所以:
- 計費腳本回傳
'accept'才會回覆。 其他結果(含腳本錯誤)都不回覆,NAS 會重送,腳本會再跑一次。 - 同一個封包處理兩次,結果要和一次相同。 範例都用
INSERT ... ON CONFLICT DO UPDATE或INSERT OR IGNORE,以 NAS 加Acct-Session-Id當主鍵(Session ID 只在同一台 NAS 內唯一)。一個 client 可以是整個網段,所以「哪一台 NAS」要再看 NAS 回報的NAS-IP-Address或NAS-Identifier,不能只看 client 名稱。 - 不想記錄的封包也回傳
'accept', 否則 NAS 會一直重送。
用什麼工具測試
範例用 FreeRADIUS 的用戶端工具測試,Debian/Ubuntu 是 freeradius-utils 套件,macOS 可以用 Homebrew 的 freeradius-server。
rradius 預設丟棄沒有 Message-Authenticator 的 Access-Request。 專案用 FreeRADIUS 3.2.10 的 radclient 測試過,它會自動加上;較舊的版本可能不會,請求就會被丟棄而沒有回應。遇到這種情況,改用 radclient 並在輸入加上 Message-Authenticator=0x00,它就會計算正確的值:
echo 'User-Name=alice,User-Password=alice-password,Message-Authenticator=0x00' | radclient 127.0.0.1:1812 auth testing123-change-me
# PAP 登入:帳號、密碼、伺服器、NAS port、共用密碼
radtest alice alice-password 127.0.0.1 0 testing123-change-me
# CHAP 登入
radtest -t chap alice alice-password 127.0.0.1 0 testing123-change-me
# 計費
echo 'User-Name=alice,Acct-Session-Id=s1,Acct-Status-Type=Start' | radclient 127.0.0.1:1813 acct testing123-change-me
# 伺服器活著嗎(Status-Server)
echo 'Message-Authenticator=0x00' | radclient 127.0.0.1:1812 status testing123-change-me
- 802.1X(EAP)用 wpa_supplicant 的
eapol_test,設定範例在第 3 章。 - TACACS+ 可以用
tacacs_client(Python 套件tacacs_plus)或直接用設備測試,見第 6 章。 - RadSec 和 TACACS+ over TLS 的憑證和握手,可以先用
openssl s_client確認,見第 10 章。 - 有些登入方式沒有現成的命令列工具可以模擬(Wi-Fi 四次交握、SIM 卡、TACACS+ over TLS 的登入)。這些情境的章節會說明自動測試怎麼驗證,以及哪些部分要等實際的設備。
- 每次登入都會寫一行認證紀錄(
[log] auth = true,預設開啟),寫明 client、名稱、哪條串接和哪個處理器做的決定,排查問題時先看這一行。