<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>rradius 使用手冊 on Embark Systems</title>
        <link>https://embark.systems/rradius/</link>
        <description>Recent content in rradius 使用手冊 on Embark Systems</description>
        <generator>Hugo -- gohugo.io</generator>
        <language>zh-hant-tw</language><atom:link href="https://embark.systems/rradius/index.xml" rel="self" type="application/rss+xml" /><item>
            <title>0. 手冊導覽</title>
            <link>https://embark.systems/rradius/00-guide/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/00-guide/</guid>
            <description>&lt;p&gt;這份手冊依常見的部署情境，一步一步說明怎麼設定 rradius。每個情境都附一組可以直接啟動的設定檔、資料表和 Lua 腳本，放在 &lt;code&gt;rradius-server/examples/scenarios/&lt;/code&gt;。所有欄位的完整說明在參考文件 &lt;code&gt;docs/usage.md&lt;/code&gt;，手冊只講情境需要的部分，並標出對應的章節。&lt;/p&gt;&#xA;&lt;p&gt;範例都有自動測試（&lt;code&gt;rradius-server/tests/scenarios_test.rs&lt;/code&gt;）：測試會照手冊的方式啟動每個情境，送出登入、計費、TACACS+ 和 CoA 請求，確認結果和手冊寫的一樣。所以範例改壞了，測試會失敗。測試做不到的部分（實體設備、真的漫遊聯盟、外部的服務），各章的「上線前」會寫明沒有測過什麼。&lt;/p&gt;&#xA;&lt;h2 id=&#34;先讀這兩章&#34;&gt;先讀這兩章&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;章&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../01-concepts/&#34; &gt;1. 基本概念&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;rradius 怎麼處理一個請求、設定檔的結構、資料放在哪裡、怎麼測試&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../02-quick-start/&#34; &gt;2. 快速開始&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;單機、帳號存在資料表，十分鐘內收到第一個 Access-Accept&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;我要做什麼看哪一章&#34;&gt;我要做什麼，看哪一章&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;我要…&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;章&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;讓員工用帳號密碼或憑證連公司 Wi-Fi&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/&#34; &gt;3&lt;/a&gt;，進階的撤銷和漫遊在 &lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/&#34; &gt;15&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;讓不會 802.1X 的設備連 Wi-Fi，但每人密碼不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../12-psk-wifi/&#34; &gt;12&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;讓裝了自家 SIM 卡的設備連 Wi-Fi&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../13-sim-wifi/&#34; &gt;13&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;讓印表機、IP 電話這類設備上有線網路&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../04-wired-mab/&#34; &gt;4&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;讓 VPN 用公司的目錄登入，或加上驗證碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../05-remote-access/&#34; &gt;5&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;管理誰能登入路由器、能下哪些指令&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../06-device-admin/&#34; &gt;6&lt;/a&gt;，改用 TLS 在 &lt;a class=&#34;link&#34; href=&#34;../16-device-admin-tls/&#34; &gt;16&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;經營寬頻：方案、同時上線數、踢人、計費&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../07-broadband/&#34; &gt;7&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;任何一台停機都不中斷服務&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;8&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;把別的單位的帳號轉給他們自己的伺服器&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../09-realm-proxy/&#34; &gt;9&lt;/a&gt;，加入漫遊聯盟在 &lt;a class=&#34;link&#34; href=&#34;../11-roaming/&#34; &gt;11&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 在網際網路另一頭或 NAT 後面&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../10-radsec/&#34; &gt;10&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;管理幾百台常變動的 NAS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../14-branch-nas/&#34; &gt;14&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號已經在別的系統裡，不想複製&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;目錄（LDAP／AD）看 &lt;a class=&#34;link&#34; href=&#34;../05-remote-access/&#34; &gt;5&lt;/a&gt;，HTTP API 看 &lt;a class=&#34;link&#34; href=&#34;../18-external-api/&#34; &gt;18&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;從舊的認證系統搬過來，不想讓大家重設密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../17-migrate-users/&#34; &gt;17&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上線之後的日常工作&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../19-operations/&#34; &gt;19&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;出了問題，從現象找原因&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../20-troubleshooting/&#34; &gt;20&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;依情境&#34;&gt;依情境&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;章&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;情境&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;用到的功能&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;範例目錄&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/&#34; &gt;3. 企業 Wi-Fi&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;802.1X：公司電腦用憑證，員工手機用帳號密碼，依群組分 VLAN&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-TLS、PEAP、&lt;code&gt;certificate_query&lt;/code&gt;、動態 VLAN&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;enterprise-wifi/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../04-wired-mab/&#34; &gt;4. 有線網路 MAC 認證&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;印表機、IP 電話這類不會 802.1X 的設備&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Lua 腳本、網段 client&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;wired-mab/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../05-remote-access/&#34; &gt;5. 遠端存取&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;VPN 用公司目錄（LDAP／AD）登入，跳板機加 TOTP 驗證碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;LDAP、群組、具名串接、Access-Challenge&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;remote-access/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../06-device-admin/&#34; &gt;6. 網路設備管理&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;管理員登入路由器，依角色限制指令並記錄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TACACS+ 認證、授權、計費、授權群組&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;device-admin/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../07-broadband/&#34; &gt;7. 寬頻業者&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PPPoE／IPoE：方案速率、同時上線數、帳務系統踢人&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;all_accept&lt;/code&gt;、計費、CoA 轉送、計費暫存&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;broadband/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;8. 高可用叢集&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;三個節點，任一台停掉都能繼續服務&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;hiqlite 叢集、WireGuard、migration&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;ha-cluster/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../09-realm-proxy/&#34; &gt;9. 依 realm 轉送&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;合作單位或總部的帳號轉給對方的伺服器&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy]&lt;/code&gt;、容錯、RadSec 上游&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;realm-proxy/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../10-radsec/&#34; &gt;10. RadSec&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 經過不信任的網路或在 NAT 後面；踢人的請求走 NAS 自己的連線&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.tls]&lt;/code&gt;、&lt;code&gt;tls_name&lt;/code&gt;、CoA 走 RadSec、&lt;code&gt;coa_sender&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radsec/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../11-roaming/&#34; &gt;11. 漫遊聯盟&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;eduroam 這一類：來訪者轉給他的學校，自己的人從聯盟送回來&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy.discovery]&lt;/code&gt;（DNS）、負載平衡和比重、主動檢查、轉送計費的暫存&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;roaming/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../12-psk-wifi/&#34; &gt;12. 每人一把 Wi-Fi 密碼&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一個 WPA2-PSK 的 SSID，每人自己的密碼，依人分 VLAN&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.dpsk]&lt;/code&gt;、&lt;code&gt;dpsk-seal&lt;/code&gt;、依 MAC 回覆密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;psk-wifi/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../13-sim-wifi/&#34; &gt;13. 用 SIM 卡登入 Wi-Fi&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;自己發的 USIM 卡，不用憑證也沒有密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-AKA&amp;rsquo;、&lt;code&gt;aka-seal&lt;/code&gt;、主金鑰、頻率限制&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;sim-wifi/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../14-branch-nas/&#34; &gt;14. 幾百台分店的 NAS&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 寫在資料表，新增一台不必改設定檔&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.dynamic_clients]&lt;/code&gt;、&lt;code&gt;client&lt;/code&gt; 指令&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;branch-nas/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/&#34; &gt;15. 憑證的撤銷和快速重新連線&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;遺失的筆電要撤銷；設備漫遊時不要每次重做握手&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CRL、OCSP、&lt;code&gt;resumption_ms&lt;/code&gt;、&lt;code&gt;shared_tickets&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;wifi-certs/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../16-device-admin-tls/&#34; &gt;16. TACACS+ over TLS&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備管理從共用密碼移轉到 TLS 1.3 和設備憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[tacacs.tls]&lt;/code&gt;、&lt;code&gt;tls_name&lt;/code&gt;、&lt;code&gt;tls_only&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;device-admin-tls/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../17-migrate-users/&#34; &gt;17. 從舊系統搬帳號&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;舊的密碼雜湊原樣搬過來，之後逐步換成新格式&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各種密碼格式、名稱正規化、&lt;code&gt;[accounts]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrate-users/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../18-external-api/&#34; &gt;18. 帳號在別的系統&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每次登入用 HTTPS 問會員系統的 API&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[lua.http]&lt;/code&gt;、&lt;code&gt;http_request&lt;/code&gt;、&lt;code&gt;verifies_password&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;external-api/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;上線之後&#34;&gt;上線之後&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;章&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../19-operations/&#34; &gt;19. 日常維運&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號和設定的變更、重新載入、更換密碼和金鑰、監控指標、過載、計費暫存、升級、備份&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../20-troubleshooting/&#34; &gt;20. 依症狀排查&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有回應、被拒絕、很慢、計費不見、TLS 連不上、啟動失敗，各從哪裡看起&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;範例的共同約定&#34;&gt;範例的共同約定&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;設定檔裡的相對路徑以設定檔所在目錄為準，&lt;/strong&gt; 所以每個情境都能直接在 repo 裡啟動：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cargo build --release&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/quick-start/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;用發行檔時，&lt;/strong&gt; 解開 &lt;code&gt;rradius-&amp;lt;版本&amp;gt;-&amp;lt;平台&amp;gt;.tar.gz&lt;/code&gt;，裡面的目錄結構和 repo 相同。進到其中的 &lt;code&gt;rradius-server/&lt;/code&gt; 目錄，把各章的 &lt;code&gt;./target/release/rradius-server&lt;/code&gt; 換成 &lt;code&gt;../bin/rradius-server&lt;/code&gt;，其他指令和路徑都一樣，也不用 &lt;code&gt;cargo build&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-0.1.0-linux-x86_64/rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;../bin/rradius-server --config examples/scenarios/quick-start/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;有些情境要先執行一個腳本才能啟動，&lt;/strong&gt; 因為憑證和金鑰不該放在 repo 裡：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;腳本&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;情境&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;產生什麼&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;make-certs.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;enterprise-wifi/&lt;/code&gt;、&lt;code&gt;radsec/&lt;/code&gt;、&lt;code&gt;roaming/&lt;/code&gt;、&lt;code&gt;device-admin-tls/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;certs/&lt;/code&gt; 裡示範用的 CA 和憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;setup.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;psk-wifi/&lt;/code&gt;、&lt;code&gt;sim-wifi/&lt;/code&gt;、&lt;code&gt;wifi-certs/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;金鑰檔（權限 0600），以及用它封存的示範資料或憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;這些都只供測試。&lt;code&gt;setup.sh&lt;/code&gt; 不會覆蓋已經有的檔案；要從頭再來，停止伺服器後刪掉它產生的檔案和 &lt;code&gt;data/&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;密碼檔（&lt;code&gt;*.secret&lt;/code&gt;）都是示範值，&lt;/strong&gt; 內容寫明 &lt;code&gt;change-me&lt;/code&gt;。正式環境一定要換掉，見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e6%9b%b4%e6%8f%9b%e5%af%86%e7%a2%bc&#34; &gt;第 19 章&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;示範資料放在 &lt;code&gt;migrations/2_demo_*.sql&lt;/code&gt;&lt;/strong&gt;（搬帳號的情境是 &lt;code&gt;2_imported_users.sql&lt;/code&gt;），結構放在 &lt;code&gt;1_schema.sql&lt;/code&gt;。正式環境請刪掉示範資料的檔案，或在第一次啟動前換成自己的資料。檔案一旦套用就不能再改，見&lt;a class=&#34;link&#34; href=&#34;../01-concepts/#%e8%b3%87%e6%96%99%e8%a1%a8%e5%92%8c-migration&#34; &gt;第 1 章&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;埠號用標準值&lt;/strong&gt;（1812、1813、2083、3799、49、300）。在同一台機器上同時啟動兩個情境會衝突，一次啟動一個，或改埠。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;啟動後產生的 &lt;code&gt;data/&lt;/code&gt;、&lt;code&gt;spool/&lt;/code&gt;、&lt;code&gt;certs/&lt;/code&gt; 和金鑰檔不進 git。&lt;/strong&gt; 要從頭再來一次，停止伺服器後刪掉 &lt;code&gt;data/&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;NAS 的位址都是示範用的私有網段。&lt;/strong&gt; 本機測試時要把 client 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;（快速開始已經是），否則請求會被當成不認得的來源而沒有回應。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;幾個情境共用檔案：&lt;/strong&gt; 多數情境的計費用 &lt;code&gt;quick-start/accounting.lua&lt;/code&gt;，&lt;code&gt;device-admin-tls/&lt;/code&gt; 用 &lt;code&gt;device-admin/&lt;/code&gt; 的腳本和資料表。複製情境到別處時，把它引用的目錄一起帶走。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;</description>
        </item><item>
            <title>1. 基本概念</title>
            <link>https://embark.systems/rradius/01-concepts/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/01-concepts/</guid>
            <description>&lt;h2 id=&#34;rradius-做什麼&#34;&gt;rradius 做什麼&#xA;&lt;/h2&gt;&lt;p&gt;rradius 是 AAA 伺服器：網路設備（NAS：無線控制器、交換器、VPN 閘道、BNG、路由器）在有人要上網或登入時來問它三件事：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;認證（Authentication）&lt;/strong&gt;：這個人是誰，密碼或憑證對不對。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;授權（Authorization）&lt;/strong&gt;：通過之後給他什麼，例如 VLAN、速率、權限等級、能下哪些指令。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費（Accounting）&lt;/strong&gt;：他什麼時候上線、下線，用了多少流量。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;設備和 rradius 之間用兩種協定：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;協定&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;用在哪裡&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;埠&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RADIUS（UDP）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;使用者上網：Wi-Fi、有線 802.1X、VPN、PPPoE&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;認證 1812、計費 1813&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec（RADIUS over TLS）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;要經過不信任網路的 RADIUS（第 10 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;2083&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TACACS+（TCP）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;管理員登入網路設備（第 6 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;49&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TACACS+ over TLS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同上，整條連線放進 TLS 1.3（第 16 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;300&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;另外，其他系統可以把「踢人」「改權限」的請求（Disconnect、CoA）送到 3799 埠，由 rradius 轉給 NAS（第 7、10 章）。&lt;/p&gt;&#xA;&lt;h2 id=&#34;一個請求怎麼被處理&#34;&gt;一個請求怎麼被處理&#xA;&lt;/h2&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;NAS ──Access-Request──► rradius&#xA;                          │&#xA;                          ├─ 來源不是設定的 client ─────────► 丟棄，不回應&#xA;                          │    （有 [radius.dynamic_clients] 而且來源在它的網段裡：先查資料表，第 14 章）&#xA;                          ├─ Status-Server ─────────────────► 直接回答（status_server = true 時）&#xA;                          ├─ 名稱的 realm 符合 [proxy] ──────► 轉給上游，回應原樣帶回（第 9、11 章）&#xA;                          ├─ 帶 EAP-Message ────────────────► EAP（TLS、PEAP、TTLS、AKA&amp;#39;）完成後&#xA;                          │                                    把名稱交給下面的串接（第 3、13、15 章）&#xA;                          ├─ 帶 Wi-Fi 四次交握的內容 ───────► [radius.dpsk] 找出是誰的密碼，&#xA;                          │                                    再把那個人交給下面的串接（第 12 章）&#xA;                          ├─ client 有 auth = &amp;#34;名稱&amp;#34; ───────► 那條具名串接&#xA;                          ├─ 有 [[auth.handlers]] ──────────► 預設串接&#xA;                          └─ 都沒有 ────────────────────────► [lua].script&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;認證串接（&lt;code&gt;[auth]&lt;/code&gt;）&lt;/strong&gt; 把幾個處理器（&lt;code&gt;sql&lt;/code&gt;、&lt;code&gt;ldap&lt;/code&gt;、&lt;code&gt;lua&lt;/code&gt;）依序執行。&lt;code&gt;first_match&lt;/code&gt; 由第一個有意見的處理器決定；&lt;code&gt;all_accept&lt;/code&gt; 要每個處理器都同意，常用來「先比對密碼，再檢查政策」。見 usage 第 3 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;最上層腳本（&lt;code&gt;[lua].script&lt;/code&gt;）&lt;/strong&gt; 一定要有。它處理&lt;strong&gt;所有計費&lt;/strong&gt;和 &lt;strong&gt;TACACS+ 的授權&lt;/strong&gt;，也處理沒有串接的認證。所以有串接的情境，最上層腳本通常只寫計費。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費（Accounting-Request）&lt;/strong&gt; 不經過串接，一律交給最上層腳本；名稱符合 &lt;code&gt;[proxy]&lt;/code&gt; 時轉給上游。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;RadSec 進來的請求走同一條路。&lt;/strong&gt; 差別只在怎麼認得 NAS（憑證）和封包怎麼保護（TLS）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不回應是刻意的。&lt;/strong&gt; 來源不認得、簽章不對、太忙、上游沒回應時，rradius 都不回應，讓 NAS 重送或改用備援。「沒有回應」怎麼查，見&lt;a class=&#34;link&#34; href=&#34;../20-troubleshooting/#nas-%e9%80%81%e4%ba%86%e8%ab%8b%e6%b1%82%e5%ae%8c%e5%85%a8%e6%b2%92%e6%9c%89%e5%9b%9e%e6%87%89&#34; &gt;第 20 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;設定檔的結構&#34;&gt;設定檔的結構&#xA;&lt;/h2&gt;&lt;p&gt;一個設定檔就是一台伺服器。常見的區段：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;區段&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;必要&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;dictionary&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RADIUS 字典檔，repo 的 &lt;code&gt;share/dictionary&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[lua]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;最上層腳本和腳本的時限&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[cluster]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料目錄、叢集密碼、節點、migration&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[auth]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;認證串接&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius]&lt;/code&gt;、&lt;code&gt;[[radius.clients]]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RADIUS 的埠和可以來問的設備&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用 RADIUS 時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.tls]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec（第 10 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.eap]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;802.1X 用的 EAP 和憑證（第 3、13、15 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用 EAP 時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.dpsk]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每人一把 Wi-Fi 密碼（第 12 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.dynamic_clients]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;從資料表查 NAS（第 14 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.coa]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;接收其他系統送來的斷線請求（第 7、10 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.accounting_spool]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料庫寫不進去時暫存計費（第 7 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[tacacs]&lt;/code&gt;、&lt;code&gt;[[tacacs.clients]]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TACACS+（第 6 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用 TACACS+ 時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[tacacs.tls]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TACACS+ over TLS（第 16 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;依 realm 轉送（第 9、11 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[lua.http]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;讓腳本呼叫 HTTP API（第 18 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[accounts]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius-server user&lt;/code&gt; 指令執行的 SQL（第 19 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[metrics]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Prometheus 指標&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[log]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄格式、等級、追蹤特定使用者&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;否&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;code&gt;[radius]&lt;/code&gt; 和 &lt;code&gt;[tacacs]&lt;/code&gt; 至少要有一個。每個區段都拒絕不認得的欄位，所以欄位拼錯時啟動就會失敗並指出名稱。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;相對路徑以設定檔所在目錄為準，&lt;/strong&gt; 和從哪裡啟動無關。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;密碼一律放檔案&lt;/strong&gt;（&lt;code&gt;secret_file&lt;/code&gt;），不要寫在設定檔裡。檔案結尾的換行會去掉。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;金鑰檔的權限會被檢查。&lt;/strong&gt; 保護資料表內容的金鑰（&lt;code&gt;aka.key&lt;/code&gt;、&lt;code&gt;dpsk.key&lt;/code&gt;、&lt;code&gt;ticket.seal&lt;/code&gt;）只能是 0600、0640、0400 這類權限，別人讀得到就拒絕啟動。它們不在 repo 裡，由各情境的 &lt;code&gt;setup.sh&lt;/code&gt; 產生。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;設定錯誤在啟動時就失敗&lt;/strong&gt;（狀態碼 2），訊息會指出欄位。上線前用 &lt;code&gt;--check&lt;/code&gt; 檢查：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server --check --config /etc/rradius/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;它檢查設定、字典、憑證、migration 檔名和腳本語法，但不連資料庫和 LDAP，所以 SQL 寫錯、LDAP 密碼錯誤要啟動後才知道。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;client誰可以來問&#34;&gt;client：誰可以來問&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;[[radius.clients]]&lt;/code&gt; 列出可以送請求的設備，每個有位址（單一 IP 或網段）和共用密碼。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;wlc&amp;#34;&lt;/span&gt;                 &lt;span style=&#34;color:#75715e&#34;&gt;# 記錄、指標和腳本裡的 client 都用這個名稱&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.30.0.10&amp;#34;&lt;/span&gt;       &lt;span style=&#34;color:#75715e&#34;&gt;# 或 &amp;#34;10.30.0.0/24&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;wlc.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;不在名單裡的來源完全不回應。&lt;/strong&gt; 這是新手最常遇到的「伺服器沒反應」，看記錄裡的 &lt;code&gt;unknown client&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;最長前綴優先：&lt;/strong&gt; 同時有 &lt;code&gt;10.0.0.0/8&lt;/code&gt; 和 &lt;code&gt;10.30.0.10&lt;/code&gt; 時，後者比較精確，用後者。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;共用密碼要夠長，&lt;/strong&gt; 少於 16 個字元會有警告，建議 24 個以上的隨機字元。每台設備可以不同。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;預設要求 Message-Authenticator。&lt;/strong&gt; 舊設備不送時會被丟棄，要在那個 client 設 &lt;code&gt;require_message_authenticator = &amp;quot;no&amp;quot;&lt;/code&gt; 或 &lt;code&gt;&amp;quot;auto&amp;quot;&lt;/code&gt;，見 usage 2.6 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;NAS 很多又常變動時，&lt;/strong&gt; 可以不寫在設定檔，改放資料表（&lt;a class=&#34;link&#34; href=&#34;../14-branch-nas/&#34; &gt;第 14 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;NAS 用 RadSec 時，&lt;/strong&gt; 可以只靠憑證辨認，不必有固定位址（&lt;a class=&#34;link&#34; href=&#34;../10-radsec/&#34; &gt;第 10 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;資料表和-migration&#34;&gt;資料表和 migration&#xA;&lt;/h2&gt;&lt;p&gt;rradius 內建資料庫（hiqlite：SQLite 加上 Raft 複寫），單機和叢集用法相同。帳號、回覆屬性、計費這些資料表由你自己定義，寫成 SQL 檔放在 &lt;code&gt;migrations_dir&lt;/code&gt;，啟動時依編號套用：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;migrations/&#xA;  1_schema.sql        建立資料表&#xA;  2_demo_users.sql    示範資料&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;檔名是 &lt;code&gt;&amp;lt;編號&amp;gt;_&amp;lt;名稱&amp;gt;.sql&lt;/code&gt;，&lt;/strong&gt; 編號從 1 開始連續。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;套用過的檔案不能改，&lt;/strong&gt; 改了會啟動失敗。要改結構或加資料，就新增下一個編號的檔案，再重新啟動（叢集要逐台重啟）。見 usage 2.5 節。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;腳本讀寫資料：&lt;/strong&gt; &lt;code&gt;sql_query&lt;/code&gt; 讀本機副本，&lt;code&gt;sql_execute&lt;/code&gt; 寫入並複寫到所有節點。來自請求的值一律用參數傳，不要接進 SQL 字串：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-lua&#34; data-lang=&#34;lua&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;local&lt;/span&gt; rows &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; sql_query(&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT plan FROM subscribers WHERE username = ?&amp;#34;&lt;/span&gt;, {get_attr(&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name&amp;#39;&lt;/span&gt;)})&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;帳號的新增、改密碼和停用不必寫 migration：設定 &lt;code&gt;[accounts]&lt;/code&gt; 後用 &lt;code&gt;rradius-server user&lt;/code&gt; 指令，整個叢集立刻生效，見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e5%b8%b3%e8%99%9f%e5%92%8c%e8%b3%87%e6%96%99&#34; &gt;第 19 章&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;計費要能重複執行&#34;&gt;計費要能重複執行&#xA;&lt;/h2&gt;&lt;p&gt;NAS 沒收到 Accounting-Response 會重送，所以：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費腳本回傳 &lt;code&gt;&#39;accept&#39;&lt;/code&gt; 才會回覆。&lt;/strong&gt; 其他結果（含腳本錯誤）都不回覆，NAS 會重送，腳本會再跑一次。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;同一個封包處理兩次，結果要和一次相同。&lt;/strong&gt; 範例都用 &lt;code&gt;INSERT ... ON CONFLICT DO UPDATE&lt;/code&gt; 或 &lt;code&gt;INSERT OR IGNORE&lt;/code&gt;，以 NAS 加 &lt;code&gt;Acct-Session-Id&lt;/code&gt; 當主鍵（Session ID 只在同一台 NAS 內唯一）。一個 client 可以是整個網段，所以「哪一台 NAS」要再看 NAS 回報的 &lt;code&gt;NAS-IP-Address&lt;/code&gt; 或 &lt;code&gt;NAS-Identifier&lt;/code&gt;，不能只看 client 名稱。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不想記錄的封包也回傳 &lt;code&gt;&#39;accept&#39;&lt;/code&gt;，&lt;/strong&gt; 否則 NAS 會一直重送。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;用什麼工具測試&#34;&gt;用什麼工具測試&#xA;&lt;/h2&gt;&lt;p&gt;範例用 FreeRADIUS 的用戶端工具測試，Debian／Ubuntu 是 &lt;code&gt;freeradius-utils&lt;/code&gt; 套件，macOS 可以用 Homebrew 的 &lt;code&gt;freeradius-server&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;rradius 預設丟棄沒有 Message-Authenticator 的 Access-Request。&lt;/strong&gt; 專案用 FreeRADIUS 3.2.10 的 &lt;code&gt;radclient&lt;/code&gt; 測試過，它會自動加上；較舊的版本可能不會，請求就會被丟棄而沒有回應。遇到這種情況，改用 &lt;code&gt;radclient&lt;/code&gt; 並在輸入加上 &lt;code&gt;Message-Authenticator=0x00&lt;/code&gt;，它就會計算正確的值：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=alice,User-Password=alice-password,Message-Authenticator=0x00&amp;#39;&lt;/span&gt; | radclient 127.0.0.1:1812 auth testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# PAP 登入：帳號、密碼、伺服器、NAS port、共用密碼&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest alice alice-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# CHAP 登入&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest -t chap alice alice-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 計費&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=alice,Acct-Session-Id=s1,Acct-Status-Type=Start&amp;#39;&lt;/span&gt; | radclient 127.0.0.1:1813 acct testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 伺服器活著嗎（Status-Server）&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;Message-Authenticator=0x00&amp;#39;&lt;/span&gt; | radclient 127.0.0.1:1812 status testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;802.1X（EAP）用 wpa_supplicant 的 &lt;code&gt;eapol_test&lt;/code&gt;，設定範例在&lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/#3-%e7%94%a8-eapol_test-%e6%b8%ac%e8%a9%a6&#34; &gt;第 3 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;TACACS+ 可以用 &lt;code&gt;tacacs_client&lt;/code&gt;（Python 套件 &lt;code&gt;tacacs_plus&lt;/code&gt;）或直接用設備測試，見&lt;a class=&#34;link&#34; href=&#34;../06-device-admin/&#34; &gt;第 6 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;RadSec 和 TACACS+ over TLS 的憑證和握手，可以先用 &lt;code&gt;openssl s_client&lt;/code&gt; 確認，見&lt;a class=&#34;link&#34; href=&#34;../10-radsec/#3-%e7%a2%ba%e8%aa%8d%e6%8f%a1%e6%89%8b&#34; &gt;第 10 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;有些登入方式沒有現成的命令列工具可以模擬（Wi-Fi 四次交握、SIM 卡、TACACS+ over TLS 的登入）。這些情境的章節會說明自動測試怎麼驗證，以及哪些部分要等實際的設備。&lt;/li&gt;&#xA;&lt;li&gt;每次登入都會寫一行認證紀錄（&lt;code&gt;[log] auth = true&lt;/code&gt;，預設開啟），寫明 client、名稱、哪條串接和哪個處理器做的決定，排查問題時先看這一行。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;</description>
        </item><item>
            <title>2. 快速開始</title>
            <link>https://embark.systems/rradius/02-quick-start/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/02-quick-start/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 先在一台機器上把 rradius 跑起來，帳號存在資料表，用 &lt;code&gt;radtest&lt;/code&gt; 登入，再送幾筆計費確認有寫進去。之後的情境大多從這裡延伸。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/quick-start/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定檔&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;users&lt;/code&gt;、&lt;code&gt;user_reply&lt;/code&gt;、&lt;code&gt;accounting&lt;/code&gt; 三張表&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_demo_users.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;示範帳號&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;accounting.lua&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費腳本，第 3、5、8、9 章也沿用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;*.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;叢集和 NAS 的共用密碼（示範值）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-建置並檢查設定&#34;&gt;1. 建置並檢查設定&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cargo build --release&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --check --config examples/scenarios/quick-start/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;用發行檔時不必建置：解開壓縮檔，進到裡面的 &lt;code&gt;rradius-server/&lt;/code&gt; 目錄，以下的 &lt;code&gt;./target/release/rradius-server&lt;/code&gt; 都換成 &lt;code&gt;../bin/rradius-server&lt;/code&gt;（見範例的共同約定）。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-0.1.0-macos-aarch64/rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;../bin/rradius-server --check --config examples/scenarios/quick-start/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;印出 &lt;code&gt;configuration ok&lt;/code&gt; 就可以啟動。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-啟動&#34;&gt;2. 啟動&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/quick-start/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;第一次啟動會在 &lt;code&gt;examples/scenarios/quick-start/data/&lt;/code&gt; 建立資料庫並套用兩個 migration 檔。看到 &lt;code&gt;RADIUS Server listening on 127.0.0.1:1812 and 127.0.0.1:1813&lt;/code&gt; 就可以接受請求。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-登入&#34;&gt;3. 登入&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest alice alice-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;會收到 Access-Accept，帶 &lt;code&gt;Session-Timeout = 3600&lt;/code&gt; 和 &lt;code&gt;Filter-Id = &amp;quot;staff&amp;quot;&lt;/code&gt;，這兩個屬性來自 &lt;code&gt;user_reply&lt;/code&gt; 表。再試幾個：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;指令&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radtest -t chap alice alice-password ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Accept&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;alice 存明文，CHAP 可以用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radtest bob bob-password ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Accept，帶 &lt;code&gt;Reply-Message&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;bob 存 bcrypt 雜湊&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radtest -t chap bob bob-password ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CHAP 要明文，雜湊做不到&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radtest carol carol-password ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;carol 的 &lt;code&gt;enabled&lt;/code&gt; 是 0&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radtest alice wrong ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;密碼錯誤&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h3 id=&#34;4-計費&#34;&gt;4. 計費&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=alice,Acct-Session-Id=s1,Acct-Status-Type=Start&amp;#39;&lt;/span&gt; | radclient 127.0.0.1:1813 acct testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=alice,Acct-Session-Id=s1,Acct-Status-Type=Stop,Acct-Session-Time=120,Acct-Input-Octets=5000&amp;#39;&lt;/span&gt; | radclient 127.0.0.1:1813 acct testing123-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;兩筆都會收到 Accounting-Response，&lt;code&gt;accounting&lt;/code&gt; 表多了一列，&lt;code&gt;stopped&lt;/code&gt; 有值。&lt;/p&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;policy&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;first_match&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;sql&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;user_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT password FROM users WHERE username = ? AND enabled = 1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;reply_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT attribute, value FROM user_reply WHERE username = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;user_query&lt;/code&gt; 回傳密碼，&lt;/strong&gt; 第一欄的格式可以是明文或各種雜湊（&lt;code&gt;{crypt}&lt;/code&gt;、&lt;code&gt;{argon2}&lt;/code&gt;、&lt;code&gt;{SSHA}&lt;/code&gt;、&lt;code&gt;{nthash}&lt;/code&gt;…），見 usage 第 5 節。新部署建議 &lt;code&gt;{argon2}&lt;/code&gt; 或 bcrypt；要支援 CHAP 或 PEAP 的帳號只能存明文或 &lt;code&gt;{nthash}&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;停用帳號寫在查詢條件裡：&lt;/strong&gt; 查不到就等於不存在。串接只有這個處理器，所以會被拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;reply_query&lt;/code&gt; 回傳 (屬性, 值)，&lt;/strong&gt; 一列一個屬性，名稱是字典裡的名稱。值的格式不對時，就算密碼正確也會改回 Access-Reject，上線前請確認資料。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;有 &lt;code&gt;[auth]&lt;/code&gt; 時，最上層腳本只處理計費。&lt;/strong&gt; &lt;code&gt;accounting.lua&lt;/code&gt; 一開頭對非計費的請求回 &lt;code&gt;reject&lt;/code&gt;，萬一設定改了也不會放行任何人。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;accountinglua-做了什麼&#34;&gt;&lt;code&gt;accounting.lua&lt;/code&gt; 做了什麼&#xA;&lt;/h3&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;Start、Interim-Update、Stop 寫進同一列。&lt;/strong&gt; 主鍵是 client、NAS 和 &lt;code&gt;Acct-Session-Id&lt;/code&gt;。NAS 取它回報的 &lt;code&gt;NAS-IP-Address&lt;/code&gt;、&lt;code&gt;NAS-IPv6-Address&lt;/code&gt; 或 &lt;code&gt;NAS-Identifier&lt;/code&gt;，都沒有時用 client 名稱，所以一個 client 設成整個網段時，各台 NAS 也分得開。寫入用 &lt;code&gt;INSERT ... ON CONFLICT DO UPDATE&lt;/code&gt;，數字都取較大的值，所以重送、亂序都不會讓資料倒退。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Stop 只結束還開著的 session，&lt;/strong&gt; 重送的 Stop 不會改掉第一次的結束時間。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Accounting-On／Off（NAS 重開機）&lt;/strong&gt; 只結束送出它的那台 NAS 還開著的 session，&lt;code&gt;terminate_cause&lt;/code&gt; 記 11（NAS-Reboot）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;用 &lt;code&gt;Acct-Delay-Time&lt;/code&gt; 還原時間，&lt;/strong&gt; NAS 晚送或從計費暫存重放的封包不會被當成剛發生。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;超過 4 GiB 的流量&lt;/strong&gt; 由 &lt;code&gt;Acct-*-Gigawords&lt;/code&gt; 補上進位。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有 &lt;code&gt;Acct-Session-Id&lt;/code&gt; 的封包&lt;/strong&gt; 記一行 log 並回覆，不然 NAS 會一直重送。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;換成自己的資料&#34;&gt;換成自己的資料&#xA;&lt;/h2&gt;&lt;ol&gt;&#xA;&lt;li&gt;刪掉 &lt;code&gt;migrations/2_demo_users.sql&lt;/code&gt;，改成自己的帳號；或保留它、另外加 &lt;code&gt;3_*.sql&lt;/code&gt; 把示範帳號刪掉。&lt;strong&gt;正式環境第一次啟動前就決定好，&lt;/strong&gt; 套用過的檔案不能再改。&lt;/li&gt;&#xA;&lt;li&gt;換掉所有 &lt;code&gt;*.secret&lt;/code&gt; 的內容，見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e6%9b%b4%e6%8f%9b%e5%af%86%e7%a2%bc&#34; &gt;第 19 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;把 &lt;code&gt;[[radius.clients]]&lt;/code&gt; 改成你的設備位址，&lt;code&gt;[radius] bind&lt;/code&gt; 改成要服務的位址（範例只聽 &lt;code&gt;127.0.0.1&lt;/code&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;[metrics]&lt;/code&gt; 只綁內部位址，它沒有認證。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radtest&lt;/code&gt; 沒有回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址不在 &lt;code&gt;[[radius.clients]]&lt;/code&gt;、共用密碼不對，或埠被防火牆擋住。記錄會有 &lt;code&gt;unknown client&lt;/code&gt; 或 &lt;code&gt;Message-Authenticator&lt;/code&gt; 的訊息&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動時 &lt;code&gt;migration file ... changed after it was applied&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;改了已套用的檔案。開發時可以停掉伺服器、刪掉 &lt;code&gt;data/&lt;/code&gt; 重來；正式環境要改回原本內容，另加新檔案&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;密碼正確卻 Reject，記錄寫 &lt;code&gt;RADIUS response attribute error&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;user_reply&lt;/code&gt; 的屬性名稱或值格式不對&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費一直重送&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本出錯或沒有回傳 &lt;code&gt;&#39;accept&#39;&lt;/code&gt;，記錄會有 &lt;code&gt;Lua script error&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;更多訊息的意思見 usage 第 8 節。&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>3. 企業 Wi-Fi（802.1X）</title>
            <link>https://embark.systems/rradius/03-enterprise-wifi/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/03-enterprise-wifi/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 公司的 WPA2／WPA3-Enterprise 無線網路。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;公司配發的筆電裝了公司 CA 簽的憑證，用 &lt;strong&gt;EAP-TLS&lt;/strong&gt; 登入，放進設備 VLAN 10。&lt;/li&gt;&#xA;&lt;li&gt;員工自己的手機沒有憑證，用帳號密碼走 &lt;strong&gt;PEAP-MSCHAPv2&lt;/strong&gt;，放進員工 VLAN 20。&lt;/li&gt;&#xA;&lt;li&gt;離職的人或遺失的筆電，在資料表停用就不能登入，不必等憑證撤銷。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/enterprise-wifi/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定檔&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;make-certs.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;產生示範用的 CA、伺服器憑證和一張筆電憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;accounts&lt;/code&gt;（帳號和設備）、&lt;code&gt;group_reply&lt;/code&gt;（群組的 VLAN）、&lt;code&gt;accounting&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_demo_data.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;員工 staff1（啟用）、staff2（停用）、筆電 laptop-001&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;eapol/peap.conf&lt;/code&gt;、&lt;code&gt;eapol/tls.conf&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;eapol_test&lt;/code&gt; 的測試設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;計費沿用快速開始的 &lt;code&gt;accounting.lua&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-產生憑證&#34;&gt;1. 產生憑證&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server/examples/scenarios/enterprise-wifi&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./make-certs.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;會在 &lt;code&gt;certs/&lt;/code&gt; 產生 &lt;code&gt;ca.pem&lt;/code&gt;、&lt;code&gt;server.pem&lt;/code&gt;／&lt;code&gt;server.key&lt;/code&gt;（名稱 &lt;code&gt;radius.corp.example.com&lt;/code&gt;）和 &lt;code&gt;device.pem&lt;/code&gt;／&lt;code&gt;device.key&lt;/code&gt;（名稱 &lt;code&gt;laptop-001.corp.example.com&lt;/code&gt;）。&lt;strong&gt;只供測試。&lt;/strong&gt; 正式環境的伺服器憑證和用戶端憑證要由公司的 CA 簽發，伺服器私鑰不要離開伺服器。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-改-client-位址並啟動&#34;&gt;2. 改 client 位址並啟動&#xA;&lt;/h3&gt;&lt;p&gt;本機測試時，把 &lt;code&gt;[[radius.clients]]&lt;/code&gt; 的 &lt;code&gt;address = &amp;quot;10.30.0.10&amp;quot;&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd ../../..   &lt;span style=&#34;color:#75715e&#34;&gt;# 回到 rradius-server&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/enterprise-wifi/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;3-用-eapol_test-測試&#34;&gt;3. 用 eapol_test 測試&#xA;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;eapol_test&lt;/code&gt; 在 Debian／Ubuntu 的 &lt;code&gt;eapoltest&lt;/code&gt; 套件裡。在情境目錄執行，設定檔裡的憑證路徑才對得上：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd examples/scenarios/enterprise-wifi&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;eapol_test -c eapol/peap.conf -a 127.0.0.1 -s wlc-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;eapol_test -c eapol/tls.conf -a 127.0.0.1 -s wlc-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;兩個都要印出 &lt;code&gt;SUCCESS&lt;/code&gt;，Access-Accept 裡有 &lt;code&gt;Tunnel-Private-Group-Id&lt;/code&gt;（PEAP 是 20，TLS 是 10）。rradius 的認證紀錄：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;authentication protocol=&amp;#34;radius&amp;#34; client=&amp;#34;wlc&amp;#34; source=127.0.0.1 user=&amp;#34;anonymous@corp.example.com&amp;#34; account=&amp;#34;staff1&amp;#34; chain=&amp;#34;eap&amp;#34; handler=&amp;#34;eap-peap&amp;#34; decision=&amp;#34;accept&amp;#34;&#xA;authentication protocol=&amp;#34;radius&amp;#34; client=&amp;#34;wlc&amp;#34; source=127.0.0.1 user=&amp;#34;laptop-001.corp.example.com&amp;#34; account=&amp;#34;laptop-001.corp.example.com&amp;#34; chain=&amp;#34;eap&amp;#34; handler=&amp;#34;eap-tls&amp;#34; decision=&amp;#34;accept&amp;#34;&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;PEAP 的 &lt;code&gt;user&lt;/code&gt; 是外層的匿名名稱，&lt;code&gt;account&lt;/code&gt; 是內層的真正帳號。&lt;/p&gt;&#xA;&lt;p&gt;這兩份 &lt;code&gt;eapol_test&lt;/code&gt; 設定是在 Docker 裡用 &lt;code&gt;eapoltest&lt;/code&gt; 套件實際跑過的；這個情境的自動測試只用 PAP 確認串接和 VLAN，EAP 本身由專案的互通測試涵蓋。&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/&#34; &gt;第 15 章&lt;/a&gt;的自動測試會走完整段 EAP-TLS。&lt;/p&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;eap&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cert_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/server.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/server.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;client_ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;methods&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tls&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;peap&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;wlc&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.30.0.10&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;wlc.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;eap_methods&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tls&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;peap&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;client_ca_file&lt;/code&gt; 是簽發用戶端憑證的 CA，&lt;/strong&gt; 只信任它，不信任系統的根憑證。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;methods&lt;/code&gt; 有兩個以上時，每個 client 都要設 &lt;code&gt;eap_methods&lt;/code&gt;，&lt;/strong&gt; 列表順序就是提供順序。用戶端可以拒絕第一個、改要第二個（EAP Nak），所以只想讓某台控制器收憑證的話，那台就只列 &lt;code&gt;[&amp;quot;tls&amp;quot;]&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;憑證通過不等於可以登入。&lt;/strong&gt; 握手成功後，憑證上的名稱會交給認證串接決定，所以停用設備只要改資料表。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;sql&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;user_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT password FROM accounts WHERE name = ? AND kind = &amp;#39;user&amp;#39; AND enabled = 1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;certificate_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT 1 FROM accounts WHERE name = ? AND kind = &amp;#39;device&amp;#39; AND enabled = 1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;reply_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT r.attribute, r.value FROM accounts a JOIN group_reply r ON r.grp = a.grp WHERE a.name = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;PEAP 用 &lt;code&gt;user_query&lt;/code&gt;：&lt;/strong&gt; MS-CHAPv2 要比對明文或 NT hash，所以密碼存 &lt;code&gt;{nthash}&lt;/code&gt;（&lt;code&gt;2_demo_data.sql&lt;/code&gt; 有算法）。存 bcrypt、argon2 的帳號不能走 PEAP，要改用 EAP-TTLS 內層 PAP，見 usage 2.12 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;EAP-TLS 用 &lt;code&gt;certificate_query&lt;/code&gt;：&lt;/strong&gt; 查得到就接受。設備沒有密碼，所以不能用 &lt;code&gt;user_query&lt;/code&gt;（密碼欄是 NULL 會被拒絕）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;reply_query&lt;/code&gt; 兩種登入都用，&lt;/strong&gt; 依群組回 VLAN 的三個屬性。&lt;code&gt;Tunnel-Type:1&lt;/code&gt; 的 &lt;code&gt;:1&lt;/code&gt; 是 tag，三個屬性要用同一個 tag。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;username&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;strip_realm&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;suffix&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lowercase&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;員工可能輸入 &lt;code&gt;Staff1@corp.example.com&lt;/code&gt;，查帳號時變成 &lt;code&gt;staff1&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;憑證登入不去掉 realm：&lt;/strong&gt; 憑證證明的是完整名稱，名稱被改掉的不只大小寫時會拒絕。所以設備存憑證上的完整名稱，而且設備名稱不要有 &lt;code&gt;@&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;憑證上的名稱&#34;&gt;憑證上的名稱&#xA;&lt;/h3&gt;&lt;ul&gt;&#xA;&lt;li&gt;rradius 用憑證的 DNS SAN 和 email SAN 當名稱，兩者都沒有才用 CN。用戶端的 EAP Identity 要符合其中一個（&lt;code&gt;match_identity = true&lt;/code&gt;，預設）。&lt;/li&gt;&#xA;&lt;li&gt;用戶端把 Identity 填成匿名值時，設 &lt;code&gt;match_identity = false&lt;/code&gt;，改用憑證的第一個名稱。&lt;/li&gt;&#xA;&lt;li&gt;用腳本判斷憑證欄位（例如 OU）時用 &lt;code&gt;tls_subject_attrs&lt;/code&gt;，不要對整個主體字串做比對，見 usage 4.2 節。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;其他登入方式&#34;&gt;其他登入方式&#xA;&lt;/h2&gt;&lt;p&gt;這一章用的是最常見的兩種。其他的選擇：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;情況&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;用什麼&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;哪裡&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號的密碼只有雜湊（bcrypt、argon2、舊系統搬來的），或要讓 LDAP 用 bind 驗證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-TTLS 內層 PAP：&lt;code&gt;methods&lt;/code&gt; 加 &lt;code&gt;&amp;quot;ttls&amp;quot;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;usage 2.12 節、&lt;a class=&#34;link&#34; href=&#34;../17-migrate-users/#%e8%83%bd%e6%90%ac%e7%9a%84%e5%92%8c%e4%b8%8d%e8%83%bd%e6%90%ac%e7%9a%84&#34; &gt;第 17 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備裝了公司自己發的 USIM 卡&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-AKA&#39;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../13-sim-wifi/&#34; &gt;第 13 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備不會 802.1X，但想要每人不同的 Wi-Fi 密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每人一把 WPA2 密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../12-psk-wifi/&#34; &gt;第 12 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備什麼都不會（印表機）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;MAC 認證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../04-wired-mab/&#34; &gt;第 4 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;用戶端一定要驗證伺服器憑證。&lt;/strong&gt; PEAP 的保護全靠 TLS，用戶端不驗證時，假的基地台能拿到密碼的雜湊。用 MDM 或群組原則把 CA 和伺服器名稱（&lt;code&gt;radius.corp.example.com&lt;/code&gt;）推到裝置上，這是最常見的部署錯誤。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;伺服器憑證&lt;/strong&gt; 建議帶 &lt;code&gt;serverAuth&lt;/code&gt; 的 EKU，&lt;code&gt;make-certs.sh&lt;/code&gt; 有加。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;撤銷：&lt;/strong&gt; 設 &lt;code&gt;crl_file&lt;/code&gt; 時，憑證鏈上每一層 CA 都要有 CRL，更新後送 SIGHUP。CA 只提供 OCSP 時設 &lt;code&gt;ocsp&lt;/code&gt;。不設的話，停用設備就靠資料表的 &lt;code&gt;enabled&lt;/code&gt;。做法和取捨見&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/&#34; &gt;第 15 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;設備漫遊時每次都重做完整握手：&lt;/strong&gt; 預設是這樣。要讓重新連線的設備恢復上一次的 session，設 &lt;code&gt;resumption_ms&lt;/code&gt;，見&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/#%e5%bf%ab%e9%80%9f%e9%87%8d%e6%96%b0%e9%80%a3%e7%b7%9asession-resumption&#34; &gt;第 15 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;同一次登入要在同一個節點完成。&lt;/strong&gt; 多節點時，無線控制器要固定送到同一台（主備），或在負載平衡器依來源固定節點，見&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;這個功能還沒有在實體基地台和各作業系統上測過，&lt;/strong&gt; 只用 &lt;code&gt;eapol_test&lt;/code&gt; 驗證過。上線前請用實際的控制器和幾種手機、筆電試一次。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，提到 &lt;code&gt;eap_methods&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;methods&lt;/code&gt; 有多個方法，某個 client 沒設 &lt;code&gt;eap_methods&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PEAP 失敗，紀錄 &lt;code&gt;decision=&amp;quot;reject&amp;quot;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號不存在、停用、密碼不是明文或 &lt;code&gt;{nthash}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-TLS 握手成功但被拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;certificate_query&lt;/code&gt; 查不到：名稱和資料表不同，或 &lt;code&gt;kind&lt;/code&gt;、&lt;code&gt;enabled&lt;/code&gt; 不對&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-TLS 紀錄寫 Identity 不符&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用戶端的 Identity 和憑證的 SAN／CN 都不同，改用戶端設定或設 &lt;code&gt;match_identity = false&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;有 &lt;code&gt;UnknownRevocationStatus&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設了 &lt;code&gt;crl_file&lt;/code&gt;，但缺少某一層 CA 的 CRL&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;手機一直跳出「是否信任憑證」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;裝置上沒有 CA，或伺服器名稱和設定的不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>4. 有線網路的 MAC 認證（MAB）</title>
            <link>https://embark.systems/rradius/04-wired-mab/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/04-wired-mab/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 交換器的 port 開了 802.1X，但印表機、IP 電話、監視器不會 802.1X。交換器等不到 EAP 時，改用設備的 MAC 位址當帳號來問（MAC Authentication Bypass）。認得的設備放進它該在的 VLAN，不認得的拒絕，由交換器放進訪客或隔離 VLAN。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/wired-mab/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定檔：沒有 &lt;code&gt;[auth]&lt;/code&gt;，全部交給腳本&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;mac_devices&lt;/code&gt;（MAC、VLAN、說明）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_demo_data.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;一台印表機（VLAN 30）、一台 IP 電話（VLAN 40）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;腳本是 repo 的 &lt;code&gt;examples/mac-auth.lua&lt;/code&gt;，設定直接指向它。&lt;/p&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-改-client-並啟動&#34;&gt;1. 改 client 並啟動&#xA;&lt;/h3&gt;&lt;p&gt;範例的 client 是整個交換器管理網段 &lt;code&gt;10.40.0.0/24&lt;/code&gt;。本機測試時改成 &lt;code&gt;127.0.0.1&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/wired-mab/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;2-模擬交換器的請求&#34;&gt;2. 模擬交換器的請求&#xA;&lt;/h3&gt;&lt;p&gt;交換器的 MAB 請求把 MAC 位址放在 &lt;code&gt;User-Name&lt;/code&gt;、&lt;code&gt;User-Password&lt;/code&gt; 和 &lt;code&gt;Calling-Station-Id&lt;/code&gt;，寫法各家不同：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=00-11-22-AA-BB-CC,User-Password=00-11-22-AA-BB-CC,Calling-Station-Id=00-11-22-AA-BB-CC&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  | radclient 127.0.0.1:1812 auth switches-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;會收到 Access-Accept，帶 VLAN 30 的三個屬性（&lt;code&gt;Tunnel-Type = VLAN&lt;/code&gt;、&lt;code&gt;Tunnel-Medium-Type = IEEE-802&lt;/code&gt;、&lt;code&gt;Tunnel-Private-Group-Id = 30&lt;/code&gt;）。&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;&lt;code&gt;User-Name&lt;/code&gt;&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;&lt;code&gt;Calling-Station-Id&lt;/code&gt;&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;00-11-22-AA-BB-CC&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;00-11-22-AA-BB-CC&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Accept，VLAN 30&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;00a0.c912.3456&lt;/code&gt;（Cisco 寫法）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;00:a0:c9:12:34:56&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Accept，VLAN 40&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;001122aabbcc&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;00:00:00:00:00:01&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Reject：名稱和實際的設備不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;00ffffffffff&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;00:ff:ff:ff:ff:ff&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Reject：不認得&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;腳本做了什麼&#34;&gt;腳本做了什麼&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;MAC 位址正規化：&lt;/strong&gt; 去掉 &lt;code&gt;-&lt;/code&gt;、&lt;code&gt;:&lt;/code&gt;、&lt;code&gt;.&lt;/code&gt;，轉小寫，要剛好 12 個十六進位字元。所以資料表存 &lt;code&gt;001122aabbcc&lt;/code&gt;，不管交換器怎麼寫。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;User-Name&lt;/code&gt; 要和 &lt;code&gt;Calling-Station-Id&lt;/code&gt; 是同一個 MAC。&lt;/strong&gt; 名稱是設備自己說的，&lt;code&gt;Calling-Station-Id&lt;/code&gt; 是交換器看到的；兩者不同就拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不檢查密碼。&lt;/strong&gt; MAB 沒有秘密可以比對，只靠位址。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只處理 RADIUS 認證，&lt;/strong&gt; 計費一律回覆，TACACS+ 一律拒絕。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;這個做法的限制&#34;&gt;這個做法的限制&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;MAC 位址不是秘密。&lt;/strong&gt; 看得到設備標籤或線路的人就能冒用。把這些設備放在只能到達必要服務的 VLAN（印表機只連列印伺服器，電話只連 SIP 伺服器），不要放進一般網段。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不認得的設備被拒絕之後，&lt;/strong&gt; 要交換器設定失敗時的處理（例如放進訪客 VLAN 或維持隔離）。這是交換器的設定，不在 rradius。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;想讓不認得的設備直接進訪客 VLAN，&lt;/strong&gt; 可以改寫腳本：查不到時回 &lt;code&gt;accept&lt;/code&gt; 並設訪客 VLAN。這等於任何人插上網路線都能上網，請先確認訪客 VLAN 的範圍。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;和-8021x-用在同一台交換器&#34;&gt;和 802.1X 用在同一台交換器&#xA;&lt;/h2&gt;&lt;p&gt;同一個 port 先跑 802.1X、失敗再 MAB 時，兩種請求來自同一個 client。做法：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;把 EAP 和 MAB 分開：&lt;/strong&gt; 加 &lt;code&gt;[radius.eap]&lt;/code&gt;（第 3 章），並加一條串接處理一般帳號，&lt;code&gt;mac-auth.lua&lt;/code&gt; 放在後面當 &lt;code&gt;lua&lt;/code&gt; 處理器。&lt;code&gt;mac-auth.lua&lt;/code&gt; 開頭的註解說明了順序：先讓檢查密碼的處理器判斷名稱，它不認得時才看 MAC。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;PEAP 的串接裡，&lt;code&gt;lua&lt;/code&gt; 處理器的 &lt;code&gt;accept&lt;/code&gt; 不算數，&lt;/strong&gt; 必須有處理器真的比對過密碼，所以 MAB 規則不會讓 PEAP 不用密碼就通過。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;新增設備&#34;&gt;新增設備&#xA;&lt;/h2&gt;&lt;p&gt;目前要用新的 migration 檔加資料，例如 &lt;code&gt;3_add_cameras.sql&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-sql&#34; data-lang=&#34;sql&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;INSERT&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;INTO&lt;/span&gt; mac_devices (mac, vlan, note) &lt;span style=&#34;color:#66d9ef&#34;&gt;VALUES&lt;/span&gt; (&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;0011223344aa&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;50&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;大門監視器&amp;#39;&lt;/span&gt;);&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;放進 &lt;code&gt;migrations/&lt;/code&gt; 後重新啟動。設備多、變動頻繁時的做法見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e5%b8%b3%e8%99%9f%e5%92%8c%e8%b3%87%e6%96%99&#34; &gt;第 19 章&lt;/a&gt;。&lt;/p&gt;&#xA;</description>
        </item><item>
            <title>5. 遠端存取：VPN 用公司目錄登入，跳板機加驗證碼</title>
            <link>https://embark.systems/rradius/05-remote-access/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/05-remote-access/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;VPN 閘道&lt;/strong&gt; 用公司目錄（Active Directory 或 OpenLDAP）的帳號密碼登入。只有 &lt;code&gt;vpn-users&lt;/code&gt; 群組的人能連；IT 人員和外包人員依群組套用不同的存取規則，外包人員最多連 8 小時。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;跳板機&lt;/strong&gt;（SSH 用 pam_radius，或其他支援 RADIUS 的系統）要求密碼之後再輸入手機驗證器 App 的 6 位數驗證碼（TOTP）。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;兩種設備各用一條&lt;strong&gt;具名串接&lt;/strong&gt;：client 的 &lt;code&gt;auth = &amp;quot;名稱&amp;quot;&lt;/code&gt; 決定走哪一條。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/remote-access/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;vpn&lt;/code&gt; 和 &lt;code&gt;mfa&lt;/code&gt; 兩條串接&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;ldap.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;目錄服務帳號的密碼（示範值）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;驗證碼用的 &lt;code&gt;mfa_users&lt;/code&gt;、&lt;code&gt;mfa_pending&lt;/code&gt;，和 &lt;code&gt;accounting&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_demo_data.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;跳板機帳號 ops1，驗證碼金鑰 &lt;code&gt;JBSWY3DPEHPK3PXP&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;跳板機的腳本是 repo 的 &lt;code&gt;examples/two-step-totp.lua&lt;/code&gt;，計費沿用快速開始的 &lt;code&gt;accounting.lua&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;vpnldap-串接&#34;&gt;VPN：LDAP 串接&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;vpn&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;policy&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;first_match&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;vpn&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;ldap&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;urls&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;ldaps://dc1.corp.example.com&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;ldaps://dc2.corp.example.com&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;bind_dn&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;CN=svc-radius,OU=Service Accounts,DC=corp,DC=example,DC=com&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;bind_password_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;ldap.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;base_dn&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;OU=People,DC=corp,DC=example,DC=com&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;filter&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;(&amp;amp;(sAMAccountName={user})(!(userAccountControl:1.2.840.113556.1.4.803:=2)))&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;password_check&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;bind&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;required_groups&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;CN=vpn-users,OU=Groups,DC=corp,DC=example,DC=com&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;流程：&lt;/strong&gt; 用服務帳號 bind，以 &lt;code&gt;filter&lt;/code&gt; 找使用者（&lt;code&gt;{user}&lt;/code&gt; 會跳脫），再用使用者的 DN 和密碼 bind 一次驗證密碼。找不到就略過（交給下一個處理器），找到多筆就拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;urls&lt;/code&gt; 依序嘗試，&lt;/strong&gt; 只有連不上或逾時才換下一台。一台回錯誤（例如服務帳號密碼錯）會直接拒絕，不換台，所以服務帳號的問題會立刻浮現。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;filter&lt;/code&gt; 排除停用帳號：&lt;/strong&gt; 上面是 AD 的寫法。OpenLDAP 可以用 &lt;code&gt;(&amp;amp;(uid={user})(!(pwdAccountLockedTime=*)))&lt;/code&gt;，依目錄的設定而定，請先在自己的目錄上確認。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;required_groups&lt;/code&gt;：&lt;/strong&gt; 不在群組裡的人和密碼錯誤一樣被拒絕。預設看使用者的 &lt;code&gt;memberOf&lt;/code&gt;；目錄沒有 &lt;code&gt;memberOf&lt;/code&gt; 時改用 &lt;code&gt;group_base_dn&lt;/code&gt; 和 &lt;code&gt;group_filter&lt;/code&gt; 搜尋群組，見 usage 3.5 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;ldaps://&lt;/code&gt; 或 StartTLS。&lt;/strong&gt; &lt;code&gt;ldap://&lt;/code&gt; 會自動用 StartTLS 升級；目錄憑證不是系統信任的 CA 簽的，設 &lt;code&gt;ca_file&lt;/code&gt;。明文 LDAP 要另外設 &lt;code&gt;allow_plaintext = true&lt;/code&gt;，不建議。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;password_check = &amp;quot;bind&amp;quot;&lt;/code&gt; 只支援 PAP。&lt;/strong&gt; VPN 閘道要用 PAP 送密碼（RADIUS 會加密 &lt;code&gt;User-Password&lt;/code&gt;）。要支援 CHAP、MS-CHAPv2 或 PEAP，改用 &lt;code&gt;password_check = &amp;quot;attribute&amp;quot;&lt;/code&gt; 讀密碼屬性，前提是目錄存的是明文或 NT hash。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;vpn&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;group_reply&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;group&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;CN=it-staff,OU=Groups,DC=corp,DC=example,DC=com&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;attributes&lt;/span&gt; = { &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;Filter-Id&amp;#34;&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;vpn-it&amp;#34;&lt;/span&gt; }&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;vpn&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;group_reply&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;group&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;CN=contractors,OU=Groups,DC=corp,DC=example,DC=com&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;attributes&lt;/span&gt; = { &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;Filter-Id&amp;#34;&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;vpn-contractor&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;Session-Timeout&amp;#34;&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;28800&amp;#34;&lt;/span&gt; }&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;使用者屬於哪個群組，就帶回那組屬性。&lt;strong&gt;VPN 閘道上要有同名的 filter 或 group policy，&lt;/strong&gt; 屬性名稱也依閘道而定（有些用 &lt;code&gt;Class&lt;/code&gt;，有些用廠商屬性）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;reply_attributes&lt;/code&gt; 可以把使用者自己的 LDAP 屬性變成 RADIUS 屬性，例如每個人固定的 IP。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;vpn&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;username&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;strip_realm&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;both&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lowercase&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;使用者可能輸入 &lt;code&gt;CORP\alice&lt;/code&gt; 或 &lt;code&gt;alice@corp.example.com&lt;/code&gt;，查目錄時都變成 &lt;code&gt;alice&lt;/code&gt;。具名串接不會繼承 &lt;code&gt;[auth.username]&lt;/code&gt;，要寫在自己的串接底下。&lt;/p&gt;&#xA;&lt;h3 id=&#34;測試-vpn-串接&#34;&gt;測試 VPN 串接&#xA;&lt;/h3&gt;&lt;p&gt;範例的 LDAP 位址是虛構的，要換成自己的目錄才能測：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest alice &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;her-password&amp;#39;&lt;/span&gt; 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; vpn-gw-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;（本機測試時把 &lt;code&gt;vpn-gw&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。）認證紀錄的 &lt;code&gt;handler&lt;/code&gt; 是 &lt;code&gt;ldap&lt;/code&gt;。紀錄不分拒絕的原因（密碼錯、不在群組都一樣）。目錄出問題時會另外寫一行：連不上或逾時是 WARN 的 &lt;code&gt;auth ldap handler: &amp;lt;URL&amp;gt;: &amp;lt;錯誤&amp;gt;&lt;/code&gt;（會改試下一台）；目錄回了錯誤，例如服務帳號密碼錯，是 ERROR 的 &lt;code&gt;auth ldap handler: &amp;lt;URL&amp;gt;: &amp;lt;錯誤&amp;gt;; rejecting&lt;/code&gt;。沒有這類訊息又分不清楚時，先用 &lt;code&gt;ldapsearch&lt;/code&gt; 以服務帳號查一次這個使用者和他的 &lt;code&gt;memberOf&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;跳板機密碼加-totp&#34;&gt;跳板機：密碼加 TOTP&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;mfa&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;policy&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;first_match&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;mfa&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;script&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;../../two-step-totp.lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;流程：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;跳板機 ── Access-Request（帳號、密碼）──────────► rradius 比對密碼&#xA;       ◄─ Access-Challenge（State、&amp;#34;Enter your code&amp;#34;）&#xA;使用者輸入驗證碼&#xA;跳板機 ── Access-Request（帳號、驗證碼、State）──► rradius 驗證 TOTP&#xA;       ◄─ Access-Accept&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;State&lt;/code&gt; 只能用一次，60 秒內有效。&lt;/strong&gt; 存在 &lt;code&gt;mfa_pending&lt;/code&gt;，第二步用 &lt;code&gt;DELETE&lt;/code&gt; 取得，兩個請求不可能用同一個挑戰。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;同一個驗證碼只能用一次：&lt;/strong&gt; 記下用過的時間步，只接受更新的。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;猜錯 5 次鎖 5 分鐘。&lt;/strong&gt; 只有知道密碼的人能觸發鎖定；密碼本身的猜測次數沒有限制，要靠跳板機或防火牆限制。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;兩步可以落在不同節點，&lt;/strong&gt; 範例的寫入都經過叢集，不受影響。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;測試&#34;&gt;測試&#xA;&lt;/h3&gt;&lt;p&gt;本機測試時把 &lt;code&gt;jump-host&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。&lt;code&gt;radtest&lt;/code&gt; 不會處理 Access-Challenge，所以分兩次送：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest ops1 ops1-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; jump-host-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 收到 Access-Challenge，記下 State 的值（0x 開頭）&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;oathtool --totp -b JBSWY3DPEHPK3PXP      &lt;span style=&#34;color:#75715e&#34;&gt;# 產生現在的驗證碼&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=ops1,User-Password=&amp;lt;驗證碼&amp;gt;,State=&amp;lt;State 的值&amp;gt;&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  | radclient 127.0.0.1:1812 auth jump-host-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;第二次收到 Access-Accept。同一個 &lt;code&gt;State&lt;/code&gt; 再送一次會被拒絕。&lt;/p&gt;&#xA;&lt;h3 id=&#34;用在-ssh-跳板機&#34;&gt;用在 SSH 跳板機&#xA;&lt;/h3&gt;&lt;p&gt;pam_radius 會把 Access-Challenge 的 &lt;code&gt;Reply-Message&lt;/code&gt; 顯示給使用者，再把輸入送回來，所以 SSH 登入時會先問密碼、再問驗證碼。&lt;code&gt;/etc/pam_radius.conf&lt;/code&gt; 寫 rradius 的位址和 &lt;code&gt;jump-host.secret&lt;/code&gt; 的內容，逾時建議 5 秒以上。&lt;/p&gt;&#xA;&lt;h3 id=&#34;換成自己的帳號&#34;&gt;換成自己的帳號&#xA;&lt;/h3&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;two-step-totp.lua&lt;/code&gt; 的密碼存在 &lt;code&gt;mfa_users.password&lt;/code&gt;，&lt;strong&gt;以明文比對。&lt;/strong&gt; 要用雜湊或改用 LDAP 驗證密碼，就要改寫腳本：例如串接改成 &lt;code&gt;all_accept&lt;/code&gt;，前面放 LDAP 處理器比對密碼，腳本只做驗證碼。這時第二步的「密碼」是驗證碼，LDAP 會拒絕，所以腳本要在有 &lt;code&gt;State&lt;/code&gt; 時接手，寫法較複雜，建議先在測試環境確認。&lt;/li&gt;&#xA;&lt;li&gt;驗證碼金鑰用 Base32，每人一把，產生後以 QR code（&lt;code&gt;otpauth://totp/...&lt;/code&gt;）給使用者掃描。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;ldap.secret&lt;/code&gt; 是目錄的服務帳號密碼，權限設成只有執行 rradius 的帳號讀得到。服務帳號只要能搜尋使用者和群組，不需要寫入權限。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;required_groups&lt;/code&gt;、&lt;code&gt;group_reply&lt;/code&gt; 的 DN 要和目錄裡的寫法一致，先用 &lt;code&gt;ldapsearch&lt;/code&gt; 確認使用者的 &lt;code&gt;memberOf&lt;/code&gt;。&lt;code&gt;memberOf&lt;/code&gt; 只有直接的成員關係；AD 要算巢狀群組時，改用 &lt;code&gt;group_base_dn&lt;/code&gt; 加 &lt;code&gt;group_filter = &amp;quot;(member:1.2.840.113556.1.4.1941:={dn})&amp;quot;&lt;/code&gt;（這個寫法還沒在 AD 上測過）。&lt;/li&gt;&#xA;&lt;li&gt;LDAP 連線會保留重用，每個 URL 最多 &lt;code&gt;pool_size&lt;/code&gt; 條（預設 4）。登入量大時調高。&lt;/li&gt;&#xA;&lt;li&gt;外包人員的 &lt;code&gt;Session-Timeout&lt;/code&gt; 要閘道支援才有效。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;</description>
        </item><item>
            <title>6. 網路設備管理（TACACS&#43;）</title>
            <link>https://embark.systems/rradius/06-device-admin/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/06-device-admin/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 網管人員用 SSH 登入路由器和交換器。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;帳號集中管理，不再每台設備各設一組本機帳號。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;netadmin&lt;/strong&gt; 角色：權限等級 15，所有指令都能下。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;noc&lt;/strong&gt; 角色：權限等級 1，只能查看（&lt;code&gt;show&lt;/code&gt;、&lt;code&gt;ping&lt;/code&gt;、&lt;code&gt;traceroute&lt;/code&gt;）。&lt;code&gt;show&lt;/code&gt; 只能接腳本列出的項目（介面、版本、VLAN、路由這類），看不到設定檔，因為裡面有密碼。&lt;/li&gt;&#xA;&lt;li&gt;每個指令都記下來：誰、從哪裡、在哪台設備、下了什麼。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;TACACS+ 把認證、授權、計費分成三種請求，設備可以每下一個指令就問一次「這個可以嗎」，這是它比 RADIUS 適合設備管理的地方。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/device-admin/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只開 TACACS+，沒有 &lt;code&gt;[radius]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;tacacs.lua&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;授權（依角色）和計費（記錄指令）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;admins&lt;/code&gt;（帳號、角色）、&lt;code&gt;tacacs_log&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_demo_data.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;netadmin1、noc1，密碼是 bcrypt&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;誰處理哪一段&#34;&gt;誰處理哪一段&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;請求&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;誰處理&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;認證（帳號密碼）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[auth]&lt;/code&gt; 的 &lt;code&gt;sql&lt;/code&gt; 處理器：&lt;code&gt;admins&lt;/code&gt; 表的 bcrypt 雜湊&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;授權（開 shell、每個指令）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;tacacs.lua&lt;/code&gt;，&lt;code&gt;phase&lt;/code&gt; 是 &lt;code&gt;&amp;quot;authorization&amp;quot;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費（登入、登出、指令記錄）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;tacacs.lua&lt;/code&gt;，&lt;code&gt;phase&lt;/code&gt; 是 &lt;code&gt;&amp;quot;accounting&amp;quot;&lt;/code&gt;，寫進 &lt;code&gt;tacacs_log&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;這個情境依使用者的角色授權，所以交給最上層腳本，腳本是主角。只依設備決定授權時，可以不寫腳本，改用下方的「授權群組」。&lt;/p&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-啟動&#34;&gt;1. 啟動&#xA;&lt;/h3&gt;&lt;p&gt;TACACS+ 用 49 埠，一般帳號不能綁 1024 以下的埠。本機測試可以先把 &lt;code&gt;[tacacs] port&lt;/code&gt; 改成 4949；正式環境見下方「上線前」。範例的 client 是 &lt;code&gt;10.50.0.0/24&lt;/code&gt;，本機測試時改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/device-admin/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;2-用-tacacs_client-測試&#34;&gt;2. 用 &lt;code&gt;tacacs_client&lt;/code&gt; 測試&#xA;&lt;/h3&gt;&lt;p&gt;&lt;code&gt;tacacs_client&lt;/code&gt; 是 Python 套件 &lt;code&gt;tacacs_plus&lt;/code&gt; 附的指令（&lt;code&gt;pip install tacacs_plus&lt;/code&gt;），參數依版本可能略有不同，以 &lt;code&gt;tacacs_client --help&lt;/code&gt; 為準：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;K&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;tacacs-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;tacacs_client -H 127.0.0.1 -p &lt;span style=&#34;color:#ae81ff&#34;&gt;4949&lt;/span&gt; -k $K -u noc1 authenticate          &lt;span style=&#34;color:#75715e&#34;&gt;# 輸入 noc1-password&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;tacacs_client -H 127.0.0.1 -p &lt;span style=&#34;color:#ae81ff&#34;&gt;4949&lt;/span&gt; -k $K -u noc1 authorize -c service&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;shell cmd&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;tacacs_client -H 127.0.0.1 -p &lt;span style=&#34;color:#ae81ff&#34;&gt;4949&lt;/span&gt; -k $K -u noc1 authorize -c service&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;shell cmd&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;show cmd-arg&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;running-config&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;請求&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;netadmin1&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;noc1&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;開 shell（&lt;code&gt;cmd=&lt;/code&gt; 空的）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;通過，&lt;code&gt;priv-lvl=15&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;通過，&lt;code&gt;priv-lvl=1&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;show interfaces&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;通過&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;通過&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;show running-config&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;通過&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;configure terminal&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;通過&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;腳本說明&#34;&gt;腳本說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-lua&#34; data-lang=&#34;lua&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;local&lt;/span&gt; cmd &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; get_attr(&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;cmd&amp;#39;&lt;/span&gt;)&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;-- 沒有 cmd：要開 shell（EXEC 授權），回覆權限等級。&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;if&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;not&lt;/span&gt; cmd &lt;span style=&#34;color:#f92672&#34;&gt;or&lt;/span&gt; cmd &lt;span style=&#34;color:#f92672&#34;&gt;==&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;then&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  set_attr(&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;priv-lvl&amp;#39;&lt;/span&gt;, role &lt;span style=&#34;color:#f92672&#34;&gt;==&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;netadmin&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;and&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;15&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;or&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt;)&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#66d9ef&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;accept&amp;#39;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;end&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;授權請求的參數&lt;/strong&gt; 都能用 &lt;code&gt;get_attr&lt;/code&gt; 讀：&lt;code&gt;service&lt;/code&gt;、&lt;code&gt;cmd&lt;/code&gt;、&lt;code&gt;protocol&lt;/code&gt; 等。同名的參數用 &lt;code&gt;get_attrs&lt;/code&gt;，例如 &lt;code&gt;get_attrs(&#39;cmd-arg&#39;)&lt;/code&gt; 拿到指令的每個參數。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;set_attr&lt;/code&gt; 加的屬性&lt;/strong&gt; 以 &lt;code&gt;名稱=值&lt;/code&gt; 回給設備（PASS_ADD）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費&lt;/strong&gt; 用 &lt;code&gt;task_id&lt;/code&gt; 加事件（&lt;code&gt;start_time&lt;/code&gt;、&lt;code&gt;stop_time&lt;/code&gt; 決定是開始還是結束）當主鍵，&lt;code&gt;INSERT OR IGNORE&lt;/code&gt;，設備重送也只留一筆。指令和參數組回一行存進 &lt;code&gt;cmd&lt;/code&gt;，例如 &lt;code&gt;show interfaces&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;帳號停用&lt;/strong&gt;（&lt;code&gt;enabled = 0&lt;/code&gt;）之後，認證和授權都會拒絕，已經登入的 session 下一個指令就會被擋。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;不寫腳本授權群組&#34;&gt;不寫腳本：授權群組&#xA;&lt;/h2&gt;&lt;p&gt;授權只依設備決定、不分使用者時，可以在設定檔寫規則，不用寫腳本的授權部分。例如核心路由器只有網管人員能登入，登入後一律權限等級 15；接入交換器給值班人員，只能查看：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;tacacs&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;authorize_groups&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;core&lt;/span&gt; = [&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;permit service=shell cmd\* {priv-lvl=15}&amp;#39;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;permit service=shell cmd=.*&amp;#39;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;access&lt;/span&gt; = [&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;permit service=shell cmd\* {priv-lvl=1}&amp;#39;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;deny cmd=show cmd-arg=(running-config|startup-config)&amp;#39;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;permit service=shell cmd=(show|ping|traceroute|exit|terminal)&amp;#39;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;tacacs&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;core-routers&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.50.0.0/24&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tacacs.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;authorize_group&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;core&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;tacacs&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;access-switches&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.60.0.0/22&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tacacs.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;authorize_group&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;access&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;依序比對，第一條成立的規則決定；&lt;code&gt;deny&lt;/code&gt; 放在較寬的 &lt;code&gt;permit&lt;/code&gt; 之前。沒有任何一條成立時拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;cmd\*&lt;/code&gt; 是設備要求開 shell 時送的 &lt;code&gt;cmd*&lt;/code&gt;，&lt;code&gt;{priv-lvl=15}&lt;/code&gt; 回給設備當權限等級。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;一定要用單引號，&lt;/strong&gt; 雙引號字串不接受 &lt;code&gt;\*&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;設了 &lt;code&gt;authorize_group&lt;/code&gt; 的設備不會執行腳本的授權部分，認證和計費照舊，所以 &lt;code&gt;tacacs.lua&lt;/code&gt; 的計費記錄仍然有效。&lt;/li&gt;&#xA;&lt;li&gt;規則不分使用者：上面的例子裡，能登入接入交換器的人都只能查看。要像本章前面那樣依角色區分，就繼續用腳本。&lt;/li&gt;&#xA;&lt;li&gt;格式和檢查的完整說明見 usage 2.3 節。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;設備端設定&#34;&gt;設備端設定&#xA;&lt;/h2&gt;&lt;p&gt;以 Cisco IOS 為例（&lt;strong&gt;還沒有在實體設備上測過&lt;/strong&gt;，不同版本的指令可能不同，上線前請在實驗設備上確認）：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;aaa new-model&#xA;tacacs server rradius-1&#xA; address ipv4 10.50.0.100&#xA; key tacacs-shared-secret-change-me&#xA;aaa group server tacacs+ RRADIUS&#xA; server name rradius-1&#xA;!&#xA;aaa authentication login default group RRADIUS local&#xA;aaa authorization exec default group RRADIUS local&#xA;aaa authorization commands 1 default group RRADIUS local&#xA;aaa authorization commands 15 default group RRADIUS local&#xA;aaa accounting exec default start-stop group RRADIUS&#xA;aaa accounting commands 1 default stop-only group RRADIUS&#xA;aaa accounting commands 15 default stop-only group RRADIUS&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;一定要保留 &lt;code&gt;local&lt;/code&gt; 當備援，&lt;/strong&gt; 並在設定前先確定本機的緊急帳號能登入。rradius 停機或網路不通時，設備會改用本機帳號；沒有備援就會把自己鎖在外面。&lt;/li&gt;&#xA;&lt;li&gt;先開認證，確認沒問題再開指令授權。設錯時可能連 &lt;code&gt;exit&lt;/code&gt; 都被拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;enable 不要交給 rradius，除非你設了 &lt;code&gt;enable = &amp;quot;login&amp;quot;&lt;/code&gt;。&lt;/strong&gt; rradius 預設拒絕 enable 請求（回 FAIL），而設備收到 FAIL 不會改用本機的 enable 密碼。兩種做法：&#xA;&lt;ul&gt;&#xA;&lt;li&gt;維持設備本機的 enable 密碼（&lt;code&gt;aaa authentication enable default enable&lt;/code&gt;）。上面的設定沒有把 enable 交給 rradius，權限等級由授權回覆的 &lt;code&gt;priv-lvl&lt;/code&gt; 決定，管理員通常不需要 enable。&lt;/li&gt;&#xA;&lt;li&gt;在 &lt;code&gt;[tacacs]&lt;/code&gt; 設 &lt;code&gt;enable = &amp;quot;login&amp;quot;&lt;/code&gt;，設備用 &lt;code&gt;aaa authentication enable default group RRADIUS enable&lt;/code&gt;。這時管理員用自己的密碼 enable，所以要在腳本裡限制，例如 &lt;code&gt;authen_service == 2&lt;/code&gt; 時只讓 &lt;code&gt;netadmin&lt;/code&gt; 角色通過。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;多台 rradius 時，&lt;code&gt;aaa group server&lt;/code&gt; 列多個 &lt;code&gt;server name&lt;/code&gt;，設備會依序嘗試。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;49 埠：&lt;/strong&gt; 用 systemd 的 &lt;code&gt;AmbientCapabilities=CAP_NET_BIND_SERVICE&lt;/code&gt;，或 &lt;code&gt;setcap cap_net_bind_service=+ep&lt;/code&gt; 給執行檔，不要用 root 執行。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;TACACS+ 的加密很弱：&lt;/strong&gt; RFC 8907 的混淆只用 MD5 和共用密碼，不能取代真正的加密。設備和 rradius 之間要走管理網路，共用密碼夠長（少於 16 個字元啟動時會有警告）且每台不同（可以用多個 &lt;code&gt;[[tacacs.clients]]&lt;/code&gt;）。設備支援 TACACS+ over TLS（RFC 9887）時改用 TLS，見&lt;a class=&#34;link&#34; href=&#34;../16-device-admin-tls/&#34; &gt;第 16 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;ASCII 登入&lt;/strong&gt;（設備問帳號、再問密碼）和 PAP 都支援。enable 預設拒絕，改密碼一律回 FAIL，見 usage 4.6 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;CHAP 和 MS-CHAPv2&lt;/strong&gt;（用 PPP 撥接的設備才會用到）由認證串接比對，所以帳號的密碼要是伺服器讀得到的形式：CHAP 要明文，MS-CHAPv2 要明文或 &lt;code&gt;{nthash}&lt;/code&gt;。範例的帳號存 bcrypt，這兩種登入會被拒絕，一般的 SSH 登入（PAP、ASCII）不受影響。沒有串接的設備收到的是 RESTART，設備可以改用 PAP。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;給使用者看的訊息：&lt;/strong&gt; 腳本用 &lt;code&gt;set_attr(&#39;server_msg&#39;, &#39;...&#39;)&lt;/code&gt; 設的文字會放進回覆，設備通常會顯示給登入的人，例如拒絕指令時說明原因。授權群組的規則不能帶訊息。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;閒置連線&lt;/strong&gt; 300 秒沒有完整封包就關閉（&lt;code&gt;idle_timeout_ms&lt;/code&gt;），每條連線最多 8 個未完成的登入。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;記錄的保存：&lt;/strong&gt; &lt;code&gt;tacacs_log&lt;/code&gt; 會一直變大，rradius 不會自動清除。清除舊資料的做法見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e6%b8%85%e9%99%a4%e8%88%8a%e8%b3%87%e6%96%99&#34; &gt;第 19 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連線馬上被關閉&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源不在 &lt;code&gt;[[tacacs.clients]]&lt;/code&gt;，記錄有 &lt;code&gt;TACACS+ connection from unknown client&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;認證回 ERROR 然後連線被關閉&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼不同，解出來的內容是亂碼。記錄有 &lt;code&gt;a body did not decode, so the shared secret may be wrong&lt;/code&gt;，&lt;code&gt;rradius_tacacs_malformed_total&lt;/code&gt; 會增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;enable&lt;/code&gt; 指令一律失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;預設拒絕 enable，記錄有 &lt;code&gt;TACACS+ enable request refused&lt;/code&gt;，見上方「設備端設定」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;能登入但每個指令都被拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;授權腳本拒絕：帳號沒有角色、&lt;code&gt;service&lt;/code&gt; 不是 &lt;code&gt;shell&lt;/code&gt;，或 &lt;code&gt;cmd&lt;/code&gt; 不在允許清單。用授權群組時，是沒有任何一條規則成立&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費回 ERROR&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本出錯，看 &lt;code&gt;Lua script error&lt;/code&gt;；設備會重送&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>7. 寬頻業者（PPPoE／IPoE）</title>
            <link>https://embark.systems/rradius/07-broadband/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/07-broadband/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 地區寬頻業者，用戶透過 BNG（寬頻接取閘道）撥接 PPPoE 或 IPoE 上網。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;每個用戶有一個&lt;strong&gt;方案&lt;/strong&gt;：方案決定速率和同時上線數（家用 1 個，企業 4 個）。&lt;/li&gt;&#xA;&lt;li&gt;欠費的用戶停權，不能再登入。&lt;/li&gt;&#xA;&lt;li&gt;計費記下每個 session 的時間、流量和配到的 IP。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;帳務系統停權時要立刻把人踢下線&lt;/strong&gt;，但它不知道用戶在哪台 BNG、session ID 是什麼，也沒有 BNG 的共用密碼。&lt;/li&gt;&#xA;&lt;li&gt;資料庫短暫出問題時，計費不能遺失。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/broadband/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;all_accept&lt;/code&gt; 串接、CoA 轉送、計費暫存&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;accounting.lua&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費：每個 session 一列，記下 NAS 和 IP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;session-limit.lua&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同時上線數的檢查&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;plans&lt;/code&gt;、&lt;code&gt;plan_reply&lt;/code&gt;、&lt;code&gt;subscribers&lt;/code&gt;、&lt;code&gt;accounting&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_demo_data.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;兩個方案、三個用戶（一個停權）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;流程&#34;&gt;流程&#xA;&lt;/h2&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;登入：BNG ──► sql 處理器（密碼、方案屬性）──► session-limit.lua（還有名額嗎）──► Accept + 速率&#xA;計費：BNG ──► accounting.lua ──► accounting 表&#xA;踢人：帳務系統 ──Disconnect-Request（只有 User-Name）──► rradius&#xA;        rradius 用 session_query 查 accounting 表 ──► 找到的每個 session 轉給它的 BNG&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;同時上線數和踢人都讀同一張 &lt;code&gt;accounting&lt;/code&gt; 表，所以只要計費正確，兩個功能就正確。&lt;/p&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-改-client-並啟動&#34;&gt;1. 改 client 並啟動&#xA;&lt;/h3&gt;&lt;p&gt;本機測試時，把 &lt;code&gt;bng-1&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 和 &lt;code&gt;billing&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 都改成 &lt;code&gt;127.0.0.1&lt;/code&gt;，&lt;code&gt;bng-1&lt;/code&gt; 的 &lt;code&gt;coa_port&lt;/code&gt; 改成 3800（否則轉給 BNG 的請求會送回 rradius 自己的 3799 埠）。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/broadband/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;2-登入和同時上線數&#34;&gt;2. 登入和同時上線數&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;S&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;bng-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest home0001 home0001-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# Access-Accept：Mikrotik-Rate-Limit = &amp;#34;100M/100M&amp;#34;、Acct-Interim-Interval = 300&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=home0001,Acct-Session-Id=bb-1,Acct-Status-Type=Start,Framed-IP-Address=100.64.0.9&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  | radclient 127.0.0.1:1813 acct $S&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest home0001 home0001-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# Access-Reject：家用方案只能一個 session，記錄有 too many sessions&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;radtest home0002 ...&lt;/code&gt; 一律被拒絕，它的 &lt;code&gt;status&lt;/code&gt; 是 &lt;code&gt;suspended&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-帳務系統踢人&#34;&gt;3. 帳務系統踢人&#xA;&lt;/h3&gt;&lt;p&gt;帳務系統只送 &lt;code&gt;User-Name&lt;/code&gt;，用自己的共用密碼簽章，送到 rradius 的 3799 埠：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=home0001&amp;#39;&lt;/span&gt; | radclient 127.0.0.1:3799 disconnect billing-coa-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;rradius 查出 home0001 還開著的 session（&lt;code&gt;bb-1&lt;/code&gt;，在 &lt;code&gt;bng-1&lt;/code&gt;），把 Disconnect-Request 加上 &lt;code&gt;Acct-Session-Id = bb-1&lt;/code&gt; 轉給 bng-1 的 &lt;code&gt;coa_port&lt;/code&gt;，再把 BNG 的回答傳回帳務系統。本機沒有真的 BNG 在 3800 埠回答，所以重試完（預設 1 秒 × 3 次）後收到 NAK，&lt;code&gt;Error-Cause&lt;/code&gt; 是 505；對沒有 session 的用戶送，會收到 NAK 503（Session Context Not Found）。&lt;/p&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;h3 id=&#34;先比對密碼再檢查名額&#34;&gt;先比對密碼，再檢查名額&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;policy&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;all_accept&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;sql&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;user_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT password FROM subscribers WHERE username = ? AND status = &amp;#39;active&amp;#39;&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;reply_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT r.attribute, r.value FROM subscribers s JOIN plan_reply r ON r.plan = s.plan WHERE s.username = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;script&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;session-limit.lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;all_accept&lt;/code&gt;：&lt;/strong&gt; 每個處理器都要接受。&lt;code&gt;sql&lt;/code&gt; 拒絕（密碼錯、停權）就不會跑腳本；&lt;code&gt;sql&lt;/code&gt; 接受後腳本才檢查名額。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不要用 &lt;code&gt;first_match&lt;/code&gt;：&lt;/strong&gt; 那樣 &lt;code&gt;sql&lt;/code&gt; 查不到名稱時會交給腳本，腳本只檢查名額，不存在的帳號就不用密碼通過了。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;reply_query&lt;/code&gt; 依方案回屬性。&lt;/strong&gt; 範例用 MikroTik 的 &lt;code&gt;Mikrotik-Rate-Limit&lt;/code&gt;；其他廠商的 BNG 用各自的屬性，例如 Cisco 的 &lt;code&gt;Cisco-AVPair&lt;/code&gt;、Juniper 的 &lt;code&gt;ERX-*&lt;/code&gt;，在 &lt;code&gt;plan_reply&lt;/code&gt; 換成你的 BNG 認得的名稱和值。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;Acct-Interim-Interval = 300&lt;/code&gt;&lt;/strong&gt; 要求 BNG 每 5 分鐘回報一次。&lt;code&gt;session-limit.lua&lt;/code&gt; 的 &lt;code&gt;STALE_AFTER&lt;/code&gt; 和 &lt;code&gt;[radius.coa]&lt;/code&gt; 的 &lt;code&gt;session_query&lt;/code&gt; 都把超過 900 秒沒回報的 session 當成已經離線（BNG 當機不會送 Stop），所以這個間隔一定要比 900 秒短。要改 900 秒時，兩個地方一起改。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;username&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lowercase&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;allowed&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;[a-z0-9._@-]+&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;HOME0001&lt;/code&gt; 和 &lt;code&gt;home0001&lt;/code&gt; 是同一個人，否則各算各的名額。&lt;code&gt;accounting.lua&lt;/code&gt; 也把名稱轉小寫。&lt;/p&gt;&#xA;&lt;h3 id=&#34;session-limitlua&#34;&gt;session-limit.lua&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-lua&#34; data-lang=&#34;lua&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;SELECT p.max_sessions AS allowed,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;       (SELECT count(&lt;span style=&#34;color:#f92672&#34;&gt;*&lt;/span&gt;) FROM accounting a&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;        WHERE a.username &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; s.username AND a.stopped IS NULL AND a.updated &lt;span style=&#34;color:#f92672&#34;&gt;&amp;gt;&lt;/span&gt; &lt;span style=&#34;color:#960050;background-color:#1e0010&#34;&gt;?&lt;/span&gt;) AS online&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;FROM subscribers s JOIN plans p ON p.name &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; s.plan&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;WHERE s.username &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color:#960050;background-color:#1e0010&#34;&gt;?&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;名額從 Accounting-Start 才算。&lt;strong&gt;兩個同時進來的登入可能都通過，&lt;/strong&gt; 這是所有「看計費算名額」做法的共同限制。&lt;/li&gt;&#xA;&lt;li&gt;叢集裡讀的是本機副本，可能比剛寫入的計費慢一點。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;auth_user&lt;/code&gt; 是串接正規化後的名稱（小寫）。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;accountinglua&#34;&gt;accounting.lua&#xA;&lt;/h3&gt;&lt;p&gt;和快速開始的相同（Start、Interim、Stop 寫進同一列，可以重複執行，NAS 重開機時結束它的 session），另外：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;nas&lt;/code&gt; 欄：&lt;/strong&gt; 送 CoA 要去的地方，取 NAS 回報的 &lt;code&gt;NAS-IP-Address&lt;/code&gt; 或 &lt;code&gt;NAS-IPv6-Address&lt;/code&gt;，都沒有時用 client 名稱。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;framed_ip&lt;/code&gt; 欄：&lt;/strong&gt; 配給用戶的 IP，後來的 Interim-Update 沒帶時保留原值。客服查「這個 IP 剛才是誰」時用得到。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;coa-轉送&#34;&gt;CoA 轉送&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;coa&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;3799&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;session_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT nas, session_id FROM accounting WHERE username = ? AND stopped IS NULL AND updated &amp;gt; strftime(&amp;#39;%s&amp;#39;, &amp;#39;now&amp;#39;) - 900 ORDER BY updated DESC&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;coa&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;billing&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.20.0.5&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;billing.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;[[radius.coa.clients]]&lt;/code&gt; 是可以要求踢人的系統，&lt;/strong&gt; 和 NAS 的名單分開。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;請求有指定 NAS（&lt;code&gt;NAS-IP-Address&lt;/code&gt; 等）時直接轉給那台，&lt;/strong&gt; 只有 &lt;code&gt;User-Name&lt;/code&gt; 時才用 &lt;code&gt;session_query&lt;/code&gt; 查。查詢只有一個 &lt;code&gt;?&lt;/code&gt;，代入 &lt;code&gt;User-Name&lt;/code&gt;，所以帳務系統沒辦法注入 SQL。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;回覆：&lt;/strong&gt; 任一台 BNG 回 ACK 就回 ACK；全部拒絕時傳回其中一個 NAK；查不到 session 回 NAK 503；查到的 NAS 都不是設定的 client 回 502；查詢失敗或 BNG 都沒回應回 505。一個用戶最多轉給 32 個 session。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;BNG 要開 CoA（RFC 5176），&lt;/strong&gt; 接受 rradius 的來源位址，埠是 client 的 &lt;code&gt;coa_port&lt;/code&gt;（預設 3799，有些設備用 1700）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只有 &lt;code&gt;User-Name&lt;/code&gt; 的請求在多台 BNG 時很方便，&lt;/strong&gt; 但查詢依賴計費：BNG 沒送 Start，就查不到。&lt;/li&gt;&#xA;&lt;li&gt;想自己從腳本或命令列踢人，見 usage 4.8 節的 &lt;code&gt;send_disconnect&lt;/code&gt; 和 &lt;code&gt;rradius-server disconnect&lt;/code&gt; 指令。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;計費暫存&#34;&gt;計費暫存&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;accounting_spool&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;dir&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;spool&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;資料庫寫不進去（叢集失去多數節點、逾時）時，計費先寫到本機目錄並回覆 BNG，恢復後由 &lt;code&gt;accounting.lua&lt;/code&gt; 重放。腳本可以重複執行，所以重放不會重複計算。暫存檔含個人資料，目錄權限是 0700；磁碟壞掉時還沒重放的就遺失了。見 usage 2.11 節。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;只暫存資料庫造成的失敗。&lt;/strong&gt; 腳本自己的錯誤、回傳 &lt;code&gt;&#39;reject&#39;&lt;/code&gt; 都不暫存，和沒有這個區段時一樣不回覆，錯誤不會被藏起來。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;重放時腳本看得出來：&lt;/strong&gt; 全域變數 &lt;code&gt;replayed&lt;/code&gt; 是 &lt;code&gt;true&lt;/code&gt;，&lt;code&gt;Acct-Delay-Time&lt;/code&gt; 已經加上待在暫存裡的時間。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;恢復前，依賴計費的功能看不到這些資料：&lt;/strong&gt; 同時上線數和踢人都讀 &lt;code&gt;accounting&lt;/code&gt; 表。&lt;code&gt;rradius_acct_spool_bytes&lt;/code&gt; 大於 0 就代表有落後，拿它告警。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;query_timeout_ms&lt;/code&gt; 決定多久才進暫存。&lt;/strong&gt; 叢集沒有多數節點時，寫入要等到 &lt;code&gt;[lua] query_timeout_ms&lt;/code&gt;（預設 5 秒）才算失敗，這段時間 BNG 收不到回覆。比 BNG 的重送間隔長時調低它。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;重放的速度（&lt;code&gt;replay_window&lt;/code&gt;）：&lt;/strong&gt; 預設一次重放一筆、依寫入順序，每秒約幾千筆。停機很久、累積很多時可以設 &lt;code&gt;replay_window = 8&lt;/code&gt; 同時重放；但同一個 session 的 Start、Interim、Stop 可能同時執行或順序顛倒。範例的 &lt;code&gt;accounting.lua&lt;/code&gt; 把三種寫進同一列、數字取較大的值，順序顛倒也沒關係；你的腳本靠先後順序時維持 1。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;重放卡住時：&lt;/strong&gt; &lt;code&gt;rejected.log&lt;/code&gt;、&lt;code&gt;.corrupt&lt;/code&gt; 檔怎麼看，見&lt;a class=&#34;link&#34; href=&#34;../20-troubleshooting/#%e8%a8%88%e8%b2%bb%e4%b8%80%e7%9b%b4%e9%87%8d%e9%80%81%e6%88%96%e8%a8%88%e8%b2%bb%e4%b8%8d%e8%a6%8b%e4%ba%86&#34; &gt;第 20 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;方案和用戶的資料從哪裡來？&lt;/strong&gt; 範例的示範用戶來自 migration 檔。範例設定已有 &lt;code&gt;[accounts]&lt;/code&gt;，可以用 &lt;code&gt;rradius-server user add|passwd|disable&lt;/code&gt; 管理用戶（停用就是把 &lt;code&gt;status&lt;/code&gt; 改成 &lt;code&gt;suspended&lt;/code&gt;）；帳務系統也可以呼叫這些指令同步，見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e5%b8%b3%e8%99%9f%e5%92%8c%e8%b3%87%e6%96%99&#34; &gt;第 19 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;IP 位址池：&lt;/strong&gt; 範例由 BNG 自己配發。要由 RADIUS 配發時參考 &lt;code&gt;examples/ip-pool.lua&lt;/code&gt;，它在整個叢集內保證同一個位址不會同時給兩個人。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;時間配額和可上網時段：&lt;/strong&gt; 參考 &lt;code&gt;examples/quota-and-hours.lua&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;accounting&lt;/code&gt; 表會一直變大，&lt;/strong&gt; 清除舊資料見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e6%b8%85%e9%99%a4%e8%88%8a%e8%b3%87%e6%96%99&#34; &gt;第 19 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;多台 BNG、多台 rradius 時，見&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;。每台 BNG 都要能收到每個 rradius 節點送的 CoA。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;BNG 在 NAT 後面、或中間是不信任的網路時，&lt;/strong&gt; BNG 用 RadSec 連進來，踢人的請求走它自己開的那條連線，見&lt;a class=&#34;link&#34; href=&#34;../10-radsec/#%e8%b8%a2%e4%ba%ba%e8%ab%8b%e6%b1%82%e8%b5%b0-nas-%e8%87%aa%e5%b7%b1%e7%9a%84%e9%80%a3%e7%b7%9a&#34; &gt;第 10 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;用戶資料在帳務系統裡、不想複製一份時，&lt;/strong&gt; 可以每次登入問帳務系統的 API，見&lt;a class=&#34;link&#34; href=&#34;../18-external-api/&#34; &gt;第 18 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用戶下線了還是被說「太多 session」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;BNG 沒送 Stop（當機、斷線），要等 900 秒；或 BNG 重開機時沒送 Accounting-On&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;踢人回 503&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;查不到開著的 session：BNG 沒送計費、名稱大小寫不同、超過 900 秒沒回報&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;踢人回 505&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;BNG 沒回應：沒開 CoA、埠不對、不接受 rradius 的來源位址、共用密碼不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;踢人的請求沒有任何回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;送出端不在 &lt;code&gt;[[radius.coa.clients]]&lt;/code&gt;，或密碼不對，計入 &lt;code&gt;rradius_coa_relay_discarded_total&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>8. 高可用叢集</title>
            <link>https://embark.systems/rradius/08-ha-cluster/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/08-ha-cluster/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 認證不能停。三台 rradius 組成叢集，資料自動複寫到每一台；任一台停機（故障、升級、重開機）時，另外兩台照常服務，NAS 自動改問活著的節點。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/ha-cluster/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;node1.toml&lt;/code&gt;、&lt;code&gt;node2.toml&lt;/code&gt;、&lt;code&gt;node3.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;三個節點的設定，只差 &lt;code&gt;node_id&lt;/code&gt;、&lt;code&gt;listen&lt;/code&gt; 和 &lt;code&gt;[metrics] bind&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;raft.secret&lt;/code&gt;、&lt;code&gt;api.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;叢集內部的密碼，三台相同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;nas.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 的共用密碼，三台相同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料表，和快速開始相同，&lt;strong&gt;沒有示範帳號&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;計費腳本沿用快速開始的 &lt;code&gt;../quick-start/accounting.lua&lt;/code&gt;，所以這一章只講叢集本身。帳號要自己加，見下面的步驟。&lt;/p&gt;&#xA;&lt;h2 id=&#34;架構&#34;&gt;架構&#xA;&lt;/h2&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;             NAS（主：node1，備：node2、node3）&#xA;              │ RADIUS 1812/1813&#xA;   ┌──────────┼───────────────┐&#xA; node1      node2           node3       每台都有完整的資料&#xA; 10.99.0.1  10.99.0.2       10.99.0.3   （WireGuard 位址）&#xA;   └──── raft 8100 / api 8200 ────┘     節點之間只走 WireGuard&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;寫入（&lt;code&gt;sql_execute&lt;/code&gt;、migration）經過 Raft，&lt;/strong&gt; 要多數節點（3 台中的 2 台）同意才成功，所以每台寫入的結果都相同。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;讀取（&lt;code&gt;sql_query&lt;/code&gt;、&lt;code&gt;sql&lt;/code&gt; 處理器）讀本機副本，&lt;/strong&gt; 很快，但可能比剛寫入的資料慢一點。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;三台是最小的高可用：&lt;/strong&gt; 停一台還有多數；兩台時停一台就沒有多數。五台可以同時停兩台。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;狀況&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;認證&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;計費&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;三台都在&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;正常&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;正常&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;停一台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;正常（NAS 改問其他台）。停的剛好是 leader 時，選出新 leader 前的幾秒，要寫入的登入不回應、計費寫入逾時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;正常；停的是 leader 時，那幾秒的計費進暫存（可能重複一次，見下方）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;停兩台，剩一台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只讀資料的認證（&lt;code&gt;sql&lt;/code&gt;、&lt;code&gt;ldap&lt;/code&gt;）讀本機副本，照常回應；要寫入的（驗證碼、IP 配發、SIM 卡）&lt;strong&gt;不回應&lt;/strong&gt;，讓 NAS 重送或改問別台。設了 &lt;code&gt;stop_without_leader_ms&lt;/code&gt; 時，超過那段時間連只讀的認證和 Status-Server 都不回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;寫不進去，有計費暫存時先寫在本機並回覆，叢集恢復後重放&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;資料庫不能用時不回應，而不是拒絕。&lt;/strong&gt; 登入因為叢集資料庫逾時或找不到 leader 而無法決定時，RADIUS 不回覆、TACACS+ 回 ERROR，這樣 NAS 和設備會改問其他節點，使用者也不會看到「密碼錯」。計入 &lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;database&amp;quot;}&lt;/code&gt;。確定是帳號不存在、密碼錯，而且腳本的資料庫呼叫都成功，才回拒絕；腳本有一次資料庫呼叫失敗後才拒絕的，也算不能決定。腳本在資料庫失敗後回 &lt;code&gt;ignore&lt;/code&gt; 時，照常交給下一個處理器。進行中的 EAP 對話會留著，NAS 重送時接著做。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;stop_without_leader_ms&lt;/code&gt;（&lt;code&gt;[cluster]&lt;/code&gt;，預設不設）：&lt;/strong&gt; 節點超過這段時間沒有 leader，就連只讀的登入和 Status-Server 都不回應（TACACS+ 回 ERROR），計入 &lt;code&gt;reason=&amp;quot;no_leader&amp;quot;&lt;/code&gt;，讓 NAS 和負載平衡器把它當成故障、改問被隔開的另一側。代價是叢集只剩這一台時，它也不服務。計費照常。改了要重啟。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;斷線很久的節點回來後可能要重啟一次。&lt;/strong&gt; 它不在的期間寫入超過 10 萬筆（&lt;code&gt;snapshot_every&lt;/code&gt;）時，回來後 hiqlite 讀不到自己的日誌，rradius 會記錄 &lt;code&gt;exiting so that a restart recovers it&lt;/code&gt; 並以狀態碼 1 結束；重新啟動後它會追上叢集。所以每個節點都要設自動重啟（systemd &lt;code&gt;Restart=on-failure&lt;/code&gt;、Docker &lt;code&gt;restart: unless-stopped&lt;/code&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;剩一台時不要重啟它。&lt;/strong&gt; 正在跑的那台會繼續服務只讀的登入，但重新啟動後要等到有 leader 才起得來（這是 hiqlite 的行為），有 &lt;code&gt;migrations_dir&lt;/code&gt; 時等 &lt;code&gt;migrations_wait_ms&lt;/code&gt; 後以狀態碼 1 結束。先救回其他節點。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;被隔開的節點讀的是舊資料。&lt;/strong&gt; 它和多數節點斷開時，在另一側停用的帳號、刪掉的 NAS、撤掉的金鑰，在它這裡都還有效，SIGHUP 也沒用，直到網路恢復。不能接受的話設 &lt;code&gt;stop_without_leader_ms&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;交給叢集的寫入會等結果。&lt;/strong&gt; 資料庫很慢（例如 leader 在做快照）或換 leader 時，腳本已經交給叢集的寫入不會中途放棄，會等到叢集回覆（最多 30 秒），所以這筆寫入不會「回報失敗、其實寫進去了」。但計費仍可能記兩次：30 秒內都沒有結果時，計費不回覆、由 NAS 重送；等得比時限久時，同一個請求之後的資料庫呼叫會立刻逾時，這筆進暫存、重放時再跑一次；帶 &lt;code&gt;RETURNING&lt;/code&gt; 的語句照舊以時限為準。所以計費腳本仍要能重複執行（例如用 &lt;code&gt;INSERT OR IGNORE&lt;/code&gt;、以 &lt;code&gt;Acct-Session-Id&lt;/code&gt; 為主鍵）。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-每台主機的準備&#34;&gt;1. 每台主機的準備&#xA;&lt;/h3&gt;&lt;ol&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;建 WireGuard 網路 &lt;code&gt;10.99.0.0/24&lt;/code&gt;，三台互為 peer，並用防火牆讓 8100、8200 只收 &lt;code&gt;wg0&lt;/code&gt; 的連線。完整步驟在 usage 2.2 節。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;把 &lt;code&gt;examples/scenarios/&lt;/code&gt; 的 &lt;code&gt;quick-start/&lt;/code&gt; 和 &lt;code&gt;ha-cluster/&lt;/code&gt; 複製到每台（例如 &lt;code&gt;/etc/rradius/&lt;/code&gt;），保持相對位置，&lt;code&gt;node*.toml&lt;/code&gt; 才找得到 &lt;code&gt;../quick-start/accounting.lua&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;加上自己的帳號：&lt;/strong&gt; 設定 &lt;code&gt;[accounts]&lt;/code&gt; 後用 &lt;code&gt;rradius-server user add&lt;/code&gt; 新增，在任何一台節點上執行都會寫到整個叢集；或在 &lt;code&gt;ha-cluster/migrations/&lt;/code&gt; 新增 &lt;code&gt;2_users.sql&lt;/code&gt;，格式見&lt;a class=&#34;link&#34; href=&#34;../02-quick-start/&#34; &gt;第 2 章&lt;/a&gt;和&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e5%b8%b3%e8%99%9f%e5%92%8c%e8%b3%87%e6%96%99&#34; &gt;第 19 章&lt;/a&gt;。不要把快速開始的 &lt;code&gt;2_demo_users.sql&lt;/code&gt; 複製過來，裡面的示範帳號用公開的密碼。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;每台的 &lt;code&gt;raft.secret&lt;/code&gt;、&lt;code&gt;api.secret&lt;/code&gt;、&lt;code&gt;nas.secret&lt;/code&gt; 和 &lt;code&gt;migrations/&lt;/code&gt; 要相同。&lt;/strong&gt; 先產生新的密碼再複製過去：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f92672&#34;&gt;(&lt;/span&gt;umask 077; openssl rand -base64 &lt;span style=&#34;color:#ae81ff&#34;&gt;32&lt;/span&gt; &amp;gt; raft.secret; openssl rand -base64 &lt;span style=&#34;color:#ae81ff&#34;&gt;32&lt;/span&gt; &amp;gt; api.secret&lt;span style=&#34;color:#f92672&#34;&gt;)&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h3 id=&#34;2-啟動&#34;&gt;2. 啟動&#xA;&lt;/h3&gt;&lt;p&gt;三台各自啟動自己的設定，順序不拘：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server --config /etc/rradius/ha-cluster/node1.toml   &lt;span style=&#34;color:#75715e&#34;&gt;# 在 node1&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server --config /etc/rradius/ha-cluster/node2.toml   &lt;span style=&#34;color:#75715e&#34;&gt;# 在 node2&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server --config /etc/rradius/ha-cluster/node3.toml   &lt;span style=&#34;color:#75715e&#34;&gt;# 在 node3&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;第一次啟動時，每台都等叢集組成（多數節點上線），再套用 migration，最多等 &lt;code&gt;migrations_wait_ms&lt;/code&gt;（範例 120 秒）。一台先起來、其他的還沒起來時，它會等待，不是故障。&lt;/li&gt;&#xA;&lt;li&gt;看到 &lt;code&gt;RADIUS Server listening&lt;/code&gt; 就能服務。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;NAS 的設定：&lt;/strong&gt; 三台都設成 RADIUS 伺服器，主備或輪流都可以，共用密碼相同。EAP 的一次登入要在同一台完成（第 3 章），所以用 EAP 時選主備，或讓負載平衡器依來源固定節點。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;3-確認&#34;&gt;3. 確認&#xA;&lt;/h3&gt;&lt;p&gt;RADIUS 走節點的實體位址，不是 WireGuard 位址；請求也要從 client 名單內的主機送出（範例是 &lt;code&gt;10.80.0.0/16&lt;/code&gt;），否則不會有回應。從那個網段的一台主機，用上面第 3 項加的帳號：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 每台都能登入（192.0.2.11 到 .13 換成三台的實體位址）&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;for&lt;/span&gt; ip in 192.0.2.11 192.0.2.12 192.0.2.13; &lt;span style=&#34;color:#66d9ef&#34;&gt;do&lt;/span&gt; radtest &amp;lt;帳號&amp;gt; &amp;lt;密碼&amp;gt; $ip &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;$(&lt;/span&gt;cat nas.secret&lt;span style=&#34;color:#66d9ef&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;&lt;/span&gt;; &lt;span style=&#34;color:#66d9ef&#34;&gt;done&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 每台的指標，在節點上或從 WireGuard 網路內&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;curl -s http://10.99.0.1:9812/metrics | grep rradius_&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;管理用的主機不在 client 網段時，暫時加一個只有它位址的 &lt;code&gt;[[radius.clients]]&lt;/code&gt;（SIGHUP 套用），測完再移除。&lt;/p&gt;&#xA;&lt;p&gt;在 node1 送 Start、在 node3 送 Stop，&lt;code&gt;accounting&lt;/code&gt; 表裡是同一列：寫入經過叢集，哪一台收到都一樣。&lt;/p&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;cluster&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;node_id&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;listen&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.99.0.1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;migrations_dir&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;migrations&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;migrations_wait_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;120000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;cluster&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;nodes&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;id&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;raft&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.99.0.1:8100&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;api&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.99.0.1:8200&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# ...id 2、3 相同&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;每台都列出全部三個節點（包含自己），&lt;/strong&gt; &lt;code&gt;node_id&lt;/code&gt; 指出自己是哪一個，一定要有編號 1。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;listen&lt;/code&gt; 寫明 WireGuard 位址。&lt;/strong&gt; 有 &lt;code&gt;[[cluster.nodes]]&lt;/code&gt; 時預設是 &lt;code&gt;0.0.0.0&lt;/code&gt;，會在所有介面上開 raft 和 api，而這兩個埠的連線沒有加密。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;[lua] query_timeout_ms = 2000&lt;/code&gt;：&lt;/strong&gt; 失去多數節點時，寫入要等這麼久才失敗、計費才寫進暫存。預設 5 秒比很多 NAS 的重送間隔長，重送會被當成處理中而丟棄。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;[radius.accounting_spool]&lt;/code&gt;：&lt;/strong&gt; 各節點只重放自己的暫存檔，所以放在持久的磁碟。&lt;code&gt;rradius_acct_spool_bytes&lt;/code&gt; 大於 0 代表有還沒寫進資料庫的計費，可以用來告警。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;[log] format = &amp;quot;json&amp;quot;&lt;/code&gt;：&lt;/strong&gt; 三台的記錄送到同一個收集系統時比較好處理。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;哪些東西是每個節點自己的&#34;&gt;哪些東西是每個節點自己的&#xA;&lt;/h3&gt;&lt;p&gt;資料表會自動複寫，但下面這些不會。規劃多節點時逐項確認：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;東西&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;每個節點&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;要注意&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定檔、腳本、字典、&lt;code&gt;migrations/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自一份&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;內容要相同。改了之後每台都要更新，並各自送 SIGHUP 或重啟&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;raft.secret&lt;/code&gt;、&lt;code&gt;api.secret&lt;/code&gt;、NAS 的共用密碼檔&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自一份&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;內容要相同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;金鑰檔：&lt;code&gt;aka.key&lt;/code&gt;（第 13 章）、&lt;code&gt;dpsk.key&lt;/code&gt;（第 12 章）、&lt;code&gt;ticket.seal&lt;/code&gt;（第 15 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自一份&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;內容要相同，而且不在資料庫裡&lt;/strong&gt;，要自己複製到每一台、另外備份&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;憑證、私鑰、撤銷清單&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自一份&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;更新時每台都要換並送 SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費暫存&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只重放自己的檔案&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;放在持久的磁碟；節點壞掉時，它還沒重放的就遺失了&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;進行中的 EAP 對話&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只在收到它的節點&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一次登入要留在同一個節點&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;恢復用的 TLS session&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;預設只在發出它的節點&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設 &lt;code&gt;shared_tickets = true&lt;/code&gt; 後 EAP-TLS 可以跨節點恢復（第 15 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記住的結果：動態 client（第 14 章）、每人一把密碼對上的金鑰（第 12 章）、DNS 找到的上游（第 11 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自記&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;改了資料表要立刻生效時，每台都要送 SIGHUP。被隔開的節點讀的是舊副本，SIGHUP 也沒用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;叢集狀態&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自看&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;/metrics&lt;/code&gt; 的 &lt;code&gt;rradius_cluster_leader&lt;/code&gt;、&lt;code&gt;rradius_cluster_is_leader&lt;/code&gt;、&lt;code&gt;rradius_cluster_applied_index&lt;/code&gt;、&lt;code&gt;rradius_cluster_seconds_without_leader&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec 連線&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連到哪台就在哪台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;在 NAS 自己的連線上送 CoA，只有握著連線的那台做得到（第 10 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-AKA&amp;rsquo; 的頻率限制（只在 &lt;code&gt;next_sqn_query&lt;/code&gt; 時）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;預設各算各的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設 &lt;code&gt;shared_budget = true&lt;/code&gt; 後整個叢集共用；用 &lt;code&gt;current_sqn_query&lt;/code&gt;、&lt;code&gt;proven_sqn_query&lt;/code&gt; 時沒有這個上限（第 13 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游的停擺狀態&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自判定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;指標、&lt;code&gt;[log.trace]&lt;/code&gt; 的計時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各自的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;叢集的總和由監控系統加總；追蹤要對有關的每一台都設&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h3 id=&#34;調整&#34;&gt;調整&#xA;&lt;/h3&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;read_connections&lt;/code&gt;：&lt;/strong&gt; 讀本機資料庫的連線數，預設是 CPU 數的兩倍（最多 32）。登入大多是讀取，連線不夠時要排隊。記憶體很緊時可以調低，每條連線有自己的快取。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;snapshot_every&lt;/code&gt;：&lt;/strong&gt; 每累積這麼多筆寫入，節點就做一次快照，預設 100000。調低的話，異常結束（斷電、SIGKILL）後重新啟動比較快，但寫入多時快照太頻繁會拖慢服務。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;多節點不會提高寫入的上限。&lt;/strong&gt; 每筆寫入都要經過同一個 leader、等多數節點確認。登入（讀取）則是每個節點各自處理，節點越多越快。分開的主機之間，每筆寫入還要多等節點之間的往返。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這三項的量測和說明見 usage 2.2 節。改了都要重新啟動。&lt;/p&gt;&#xA;&lt;h2 id=&#34;日常操作&#34;&gt;日常操作&#xA;&lt;/h2&gt;&lt;h3 id=&#34;升級或重開機&#34;&gt;升級或重開機&#xA;&lt;/h3&gt;&lt;p&gt;一次一台：停掉一台 → 升級 → 啟動 → 確認它回到叢集 → 再做下一台。每次只停一台，叢集一直保有多數。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;確認回到叢集：&lt;/strong&gt; 記錄有 &lt;code&gt;cluster node N has caught up with the cluster&lt;/code&gt;，&lt;code&gt;/metrics&lt;/code&gt; 的 &lt;code&gt;rradius_cluster_leader&lt;/code&gt; 是 1。節點啟動時會等有 leader、再等本機副本追上叢集已經寫入的資料，才開始回應，所以停機期間新增的帳號在它第一次回應時就看得到。等待的上限是 &lt;code&gt;migrations_wait_ms&lt;/code&gt;；沒設 &lt;code&gt;migrations_dir&lt;/code&gt; 又等不到時，它記一行警告後照常服務（可能用到舊資料）。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;最後才停 leader。&lt;/strong&gt; &lt;code&gt;rradius_cluster_is_leader&lt;/code&gt; 是 1 的那台最後做：停掉 leader 時要重新選舉，那幾秒的寫入會逾時。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;用 SIGTERM 或 Ctrl+C 停止，&lt;/strong&gt; 會乾淨關閉資料庫，多節點時要約 10 秒（hiqlite 先等 9.5 秒），所以 &lt;code&gt;docker stop&lt;/code&gt; 要用 &lt;code&gt;-t 30&lt;/code&gt; 或設 &lt;code&gt;stop_grace_period: 30s&lt;/code&gt;。SIGKILL（&lt;code&gt;kill -9&lt;/code&gt;、容器被強制停止）不會，下次啟動時本機資料庫會從其他節點重建，比較慢。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;加新的-migration&#34;&gt;加新的 migration&#xA;&lt;/h3&gt;&lt;ol&gt;&#xA;&lt;li&gt;把新檔案（例如 &lt;code&gt;3_add_column.sql&lt;/code&gt;）放到&lt;strong&gt;每一台&lt;/strong&gt;。&lt;/li&gt;&#xA;&lt;li&gt;逐台重啟。第一台重啟時套用到整個叢集，其他台重啟時看到已經套用。&lt;/li&gt;&#xA;&lt;li&gt;不要讓目錄內容不同的節點同時啟動，見 usage 2.5 節。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h3 id=&#34;換掉壞掉的節點&#34;&gt;換掉壞掉的節點&#xA;&lt;/h3&gt;&lt;p&gt;新主機用同一個 &lt;code&gt;node_id&lt;/code&gt;、同樣的位址和設定，空的 &lt;code&gt;data/&lt;/code&gt; 啟動，從其他節點取得資料。&lt;strong&gt;這個流程沒有實測過，&lt;/strong&gt; 請先在測試環境演練一次。目前不支援在執行中增減節點數量。&lt;/p&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動後一直沒有 &lt;code&gt;listening&lt;/code&gt;，最後以狀態碼 1 結束&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;等不到多數節點：其他節點沒啟動、WireGuard 不通、防火牆擋住、&lt;code&gt;raft.secret&lt;/code&gt; 不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某台的登入結果和其他台不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;那台的副本落後（看 &lt;code&gt;rradius_cluster_applied_index&lt;/code&gt; 和其他台比），或被隔開了（&lt;code&gt;rradius_cluster_leader&lt;/code&gt; 是 0），或 &lt;code&gt;migrations/&lt;/code&gt; 不同；看那台的記錄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;停一台之後計費變慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;停的不是 leader 時不應該。停的是 leader 時，選舉的幾秒內寫入會逾時並進暫存。停兩台時，沒有 leader 超過 5 秒後寫入立刻失敗並進暫存&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;有些登入沒有回應，&lt;code&gt;reason=&amp;quot;database&amp;quot;&lt;/code&gt; 在增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;那台連不到叢集資料庫（沒有 leader、被隔開）或資料庫太慢。看 &lt;code&gt;rradius_cluster_leader&lt;/code&gt; 和記錄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某一台完全不回應，&lt;code&gt;reason=&amp;quot;no_leader&amp;quot;&lt;/code&gt; 在增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設了 &lt;code&gt;stop_without_leader_ms&lt;/code&gt;，那台沒有 leader 太久。恢復它和其他節點之間的網路&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Wi-Fi 登入偶爾失敗，記錄提到 &lt;code&gt;State&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP 對話的後半段到了另一個節點。NAS 改成主備，或負載平衡器依來源固定節點&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某一台的 SIM 卡或每人一把密碼的登入全部失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;那台的金鑰檔（&lt;code&gt;aka.key&lt;/code&gt;、&lt;code&gt;dpsk.key&lt;/code&gt;）和其他台不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;改了資料表，有的節點馬上生效、有的沒有&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;各節點各自記住查過的結果。對每一台送 SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>9. 依 realm 轉送</title>
            <link>https://embark.systems/rradius/09-realm-proxy/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/09-realm-proxy/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 分公司的 rradius 服務分公司的 NAS。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;分公司自己的帳號（&lt;code&gt;branch1&lt;/code&gt;，或 &lt;code&gt;branch1@branch.example.com&lt;/code&gt;）在本機認證。&lt;/li&gt;&#xA;&lt;li&gt;合作單位的人來訪時用 &lt;code&gt;alice@partner.example.org&lt;/code&gt; 登入，轉給合作單位的 RADIUS 伺服器，對方有兩台，第一台沒回應時改送第二台。&lt;/li&gt;&#xA;&lt;li&gt;總部的帳號（&lt;code&gt;@hq.example.com&lt;/code&gt; 和 &lt;code&gt;@eng.hq.example.com&lt;/code&gt; 這類子網域）轉給總部。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/realm-proxy/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy]&lt;/code&gt; 和本地帳號的串接&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;partner.secret&lt;/code&gt;、&lt;code&gt;hq.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;和上游之間的共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;本地帳號（結構同快速開始）和示範帳號 branch1&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;怎麼決定轉不轉&#34;&gt;怎麼決定轉不轉&#xA;&lt;/h2&gt;&lt;p&gt;realm 是 &lt;code&gt;User-Name&lt;/code&gt; 最後一個 &lt;code&gt;@&lt;/code&gt; 之後的部分。&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;alice@partner.example.org ─► 完全相同的 realm &amp;#34;partner.example.org&amp;#34; ─► partner-1，沒回應換 partner-2&#xA;bob@eng.hq.example.com    ─► &amp;#34;*.hq.example.com&amp;#34; ─────────────────────► hq-1&#xA;carol@hq.example.com      ─► &amp;#34;hq.example.com&amp;#34; ───────────────────────► hq-1&#xA;branch1@branch.example.com ─► 沒有符合的 realm ─────────────────────► 本機的串接&#xA;branch1                    ─► 沒有 @ ───────────────────────────────► 本機的串接&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;比對順序：&lt;/strong&gt; 完全相同 → 涵蓋它的 &lt;code&gt;*.&lt;/code&gt; 項目（最長的優先）→ &lt;code&gt;*&lt;/code&gt;，不分大小寫。&lt;code&gt;*.hq.example.com&lt;/code&gt; 不涵蓋 &lt;code&gt;hq.example.com&lt;/code&gt; 本身，所以範例兩個都列。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不要隨手加 &lt;code&gt;*&lt;/code&gt;。&lt;/strong&gt; 它會把所有帶 &lt;code&gt;@&lt;/code&gt; 的名稱轉出去，包括 &lt;code&gt;branch1@branch.example.com&lt;/code&gt; 這種自己的帳號。只有「本機沒有帶 realm 的帳號」時才適合用 &lt;code&gt;*&lt;/code&gt; 當預設出口。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;轉送的請求不在本機處理：&lt;/strong&gt; 不跑串接、腳本，也不跑 EAP。802.1X 的整段 EAP 對話原樣轉送，金鑰由上游產生。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費也照 realm 轉送，&lt;/strong&gt; 只有上游回應後才回覆 NAS，不會寫進本機的計費暫存（&lt;a class=&#34;link&#34; href=&#34;../07-broadband/#%e8%a8%88%e8%b2%bb%e6%9a%ab%e5%ad%98&#34; &gt;第 7 章&lt;/a&gt;那個只管寫不進資料庫的計費）。要在上游都沒回應時先記下來，用 &lt;code&gt;[proxy.accounting_spool]&lt;/code&gt;，見&lt;a class=&#34;link&#34; href=&#34;../11-roaming/#%e4%b8%8a%e6%b8%b8%e5%85%a8%e6%8e%9b%e6%99%82%e6%9a%ab%e5%ad%98%e8%a8%88%e8%b2%bb&#34; &gt;第 11 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;p&gt;本機測試需要一台當「合作單位」的伺服器。最簡單的是另開一份快速開始，換個埠：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;把整個 &lt;code&gt;quick-start/&lt;/code&gt; 複製到 repo 以外的地方（例如 &lt;code&gt;cp -R examples/scenarios/quick-start /tmp/partner&lt;/code&gt;），在 &lt;code&gt;/tmp/partner/rradius.toml&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;dictionary&lt;/code&gt; 改成 repo 裡 &lt;code&gt;share/dictionary&lt;/code&gt; 的絕對路徑。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;auth_port = 11812&lt;/code&gt;、&lt;code&gt;acct_port = 11813&lt;/code&gt;、&lt;code&gt;[metrics] port = 19812&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;[cluster]&lt;/code&gt; 加上 &lt;code&gt;listen = &amp;quot;127.0.0.1&amp;quot;&lt;/code&gt;，最後加上 &lt;code&gt;[[cluster.nodes]]&lt;/code&gt;（&lt;code&gt;id = 1&lt;/code&gt;、&lt;code&gt;raft = &amp;quot;127.0.0.1:18100&amp;quot;&lt;/code&gt;、&lt;code&gt;api = &amp;quot;127.0.0.1:18200&amp;quot;&lt;/code&gt;），避開這台的 8100、8200。&lt;strong&gt;&lt;code&gt;listen&lt;/code&gt; 一定要寫：&lt;/strong&gt; 列了節點之後預設會聽所有介面，而示範的 &lt;code&gt;api.secret&lt;/code&gt; 是公開的。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;然後啟動它。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;在 &lt;code&gt;realm-proxy/rradius.toml&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;branch-nas&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;partner-2&lt;/code&gt; 改成 &lt;code&gt;address = &amp;quot;127.0.0.1&amp;quot;&lt;/code&gt;、&lt;code&gt;auth_port = 11812&lt;/code&gt;、&lt;code&gt;acct_port = 11813&lt;/code&gt;，&lt;code&gt;secret_file&lt;/code&gt; 指向 &lt;code&gt;../quick-start/localhost.secret&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;partner-1&lt;/code&gt; 保留原本的位址，模擬「第一台沒回應」。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;啟動 realm-proxy：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/realm-proxy/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;測試：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;S&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;branch-nas-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest Branch1@branch.example.com branch1-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S   &lt;span style=&#34;color:#75715e&#34;&gt;# 本機，Filter-Id = branch&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest bob@partner.example.org bob-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S          &lt;span style=&#34;color:#75715e&#34;&gt;# 轉給 partner，帶回 Welcome, bob&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;第二個會慢幾秒：partner-1 等了 &lt;code&gt;timeout_ms × attempts&lt;/code&gt;（3 秒 × 2）沒有回應，被判定停擺，改送 partner-2。之後的請求直接送 partner-2，每 10 秒用 Status-Server 確認一次 partner-1 回來了沒有。&lt;code&gt;radtest&lt;/code&gt; 第一次可能等不到回應而逾時，再送一次就會成功。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;timeout_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;3000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;attempts&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;2&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;check_interval_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;10000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;partner-1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;198.51.100.10&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;auth_port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;1812&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;acct_port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;1813&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;partner.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;realms&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;partner.example.org&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;partner-1&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;partner-2&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;strip_realm&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;servers&lt;/code&gt; 依序嘗試，&lt;/strong&gt; 先試沒被判定停擺的。認證和計費的埠分開判定。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;時間要算好：&lt;/strong&gt; 一台最多等 &lt;code&gt;timeout_ms × attempts&lt;/code&gt;。這段時間要比 NAS 的逾時短，否則 NAS 先放棄；&lt;code&gt;timeout_ms&lt;/code&gt; 又要比上游刻意延遲拒絕的時間長（例如 FreeRADIUS 預設延遲 1 秒才回 Access-Reject），否則錯誤密碼會被當成上游沒回應。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;strip_realm = true&lt;/code&gt;：&lt;/strong&gt; 合作單位只認得 &lt;code&gt;alice&lt;/code&gt;，就去掉 &lt;code&gt;@partner.example.org&lt;/code&gt; 再送。MS-CHAPv2（不經 EAP）的回應是用完整名稱算的，這時要保持 &lt;code&gt;false&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;上游的回應要有 Message-Authenticator&lt;/strong&gt;（&lt;code&gt;require_message_authenticator = true&lt;/code&gt;，預設）。舊的上游不送時才設 &lt;code&gt;false&lt;/code&gt;，不建議。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;都沒回應時不回覆 NAS。&lt;/strong&gt; 回 Access-Reject 會讓使用者以為密碼錯，所以讓 NAS 自己逾時、改用它的備援。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;停擺的上游怎麼回來：&lt;/strong&gt; 每 &lt;code&gt;check_interval_ms&lt;/code&gt; 用 Status-Server 問一次，有回應就恢復。上游不會回答 Status-Server 時，在那台設 &lt;code&gt;status_check = false&lt;/code&gt;，時間到就直接當成恢復，由下一個請求判斷。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;提早發現停擺（&lt;code&gt;probe_interval_ms&lt;/code&gt;）：&lt;/strong&gt; 預設只有真的請求逾時，才會判定一台上游停擺，所以它掛掉後的第一批請求都要先等。在 &lt;code&gt;[[proxy.servers]]&lt;/code&gt; 設 &lt;code&gt;probe_interval_ms = 30000&lt;/code&gt; 之後，這台超過 30 秒沒有任何回應就主動送 Status-Server，連續 3 次沒回應判定停擺。備援機平常沒有流量，特別需要它。見&lt;a class=&#34;link&#34; href=&#34;../11-roaming/#%e5%85%a8%e5%9c%8b%e4%bb%a3%e7%90%86&#34; &gt;第 11 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;本地帳號&#34;&gt;本地帳號&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;username&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;strip_realm&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;suffix&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lowercase&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;Branch1@branch.example.com&lt;/code&gt; 沒有符合任何 realm，留在本機，查帳號時變成 &lt;code&gt;branch1&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;跨組織漫遊radsec-上游&#34;&gt;跨組織漫遊：RadSec 上游&#xA;&lt;/h2&gt;&lt;p&gt;合作單位在別的組織、中間經過網際網路時，不要用 UDP 轉送，改用 RadSec（RADIUS over TLS）：整個封包都在 TLS 裡，雙方用憑證確認彼此。&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;準備憑證。&lt;/strong&gt; 向對方（或漫遊聯盟）拿到簽發對方伺服器憑證的 CA，存成 &lt;code&gt;partner-ca.pem&lt;/code&gt;。對方要驗證 rradius 時，再準備一張由對方信任的 CA 簽發的憑證和私鑰（&lt;code&gt;our-cert.pem&lt;/code&gt;、&lt;code&gt;our-cert.key&lt;/code&gt;）。問清楚對方伺服器憑證上的名稱，例如 &lt;code&gt;radius.partner.example.org&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;改上游的設定。&lt;/strong&gt; 把 &lt;code&gt;partner-1&lt;/code&gt; 換成 RadSec：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;partner-1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;198.51.100.10&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;transport&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tls&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;radius.partner.example.org&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;partner-ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cert_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;our-cert.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;our-cert.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;不設 &lt;code&gt;port&lt;/code&gt; 就是 2083，認證和計費都走這個埠，不能再寫 &lt;code&gt;auth_port&lt;/code&gt;、&lt;code&gt;acct_port&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;不用設 &lt;code&gt;secret&lt;/code&gt;：RadSec 的共用密碼固定是 &lt;code&gt;radsec&lt;/code&gt;（RFC 6614），對方也是這樣設。對方另外指定時才寫 &lt;code&gt;secret&lt;/code&gt; 或 &lt;code&gt;secret_file&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;realm 的 &lt;code&gt;servers&lt;/code&gt; 可以混用 RadSec 和 UDP 上游，照樣依序容錯。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;檢查並啟動：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --check --config examples/scenarios/realm-proxy/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;憑證檔讀不到、私鑰和憑證不配對、少了 &lt;code&gt;tls_name&lt;/code&gt; 或 &lt;code&gt;ca_file&lt;/code&gt;，這一步就會指出是哪台上游、哪個欄位。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;確認：&lt;/strong&gt; 送一個轉給對方的登入。log 會出現 &lt;code&gt;proxy server partner-1: connected to 198.51.100.10:2083&lt;/code&gt;，&lt;code&gt;/metrics&lt;/code&gt; 的 &lt;code&gt;rradius_proxy_connections_total{server=&amp;quot;partner-1&amp;quot;,result=&amp;quot;connected&amp;quot;}&lt;/code&gt; 是 1。之後的請求都走同一條連線，不會每次重新握手。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;和 UDP 上游不同的地方：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;不重送。&lt;/strong&gt; TCP 保證送達，一個請求只送一次，&lt;code&gt;attempts&lt;/code&gt; 不適用；&lt;code&gt;timeout_ms&lt;/code&gt; 內沒有回應就換下一台。一台最多等一次 &lt;code&gt;timeout_ms&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;認證和計費一起判定停擺，&lt;/strong&gt; 因為只有一個埠、一條連線。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;一條連線最多同時 256 個請求等回應，&lt;/strong&gt; 再多的排隊。對方很遠又很忙時，這會是上限（往返 10 ms 約每秒 2.5 萬個請求，估計值）。在同一台機器上量，一條連線約每秒 10 萬個請求，比 UDP 上游少一成左右，見 usage 2.13 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;CoA 也走這條連線：&lt;/strong&gt; 依 realm 轉給 RadSec 上游的 Disconnect 和 CoA，在同一條連線上送。對方要願意在這條連線上收，先向對方確認。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;撤銷清單（&lt;code&gt;crl_file&lt;/code&gt;）只在啟動和 SIGHUP 時讀，&lt;/strong&gt; 對方換了清單要 SIGHUP。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;UDP 上游要在可信任的網路上&lt;/strong&gt;（專線、VPN），因為 RADIUS 的 UDP 只加密密碼。要經過網際網路就用 RadSec 上游（見上一節）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;上游位址只能寫 IP，&lt;/strong&gt; 不能寫主機名稱。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;和 UDP 上游的共用密碼&lt;/strong&gt; 每個單位不同，要夠長。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;迴圈：&lt;/strong&gt; 兩台互相轉送時，rradius 看到自己的 Proxy-State 就丟棄並記錄。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;監控：&lt;/strong&gt; 每台上游的請求數、逾時和停擺狀態都在 &lt;code&gt;/metrics&lt;/code&gt;，見 usage 2.8 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;重新載入（SIGHUP）&lt;/strong&gt; 會套用 &lt;code&gt;[proxy]&lt;/code&gt; 的變更，所有上游重新當成正常。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;CoA 也能依 realm 轉給上游：&lt;/strong&gt; 本機找不到 NAS、而 &lt;code&gt;User-Name&lt;/code&gt; 的 realm 符合某個項目時，Disconnect 和 CoA 請求會轉給那個 realm 的上游（送到上游的 &lt;code&gt;coa_port&lt;/code&gt;，預設 3799），見 usage 4.8 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;目前沒有的：&lt;/strong&gt; 輪流分配、由腳本決定路由、DTLS、TLS-PSK。見 usage 2.13 節。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;更多做法&#34;&gt;更多做法&#xA;&lt;/h2&gt;&lt;p&gt;這一章是最基本的「依序容錯」。以下幾樣在&lt;a class=&#34;link&#34; href=&#34;../11-roaming/&#34; &gt;第 11 章&lt;/a&gt;用一個漫遊聯盟的情境說明：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;需要&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;做法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;把請求分攤到多台上游，可以設比重&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;balance = &amp;quot;load-balance&amp;quot;&lt;/code&gt;、&lt;code&gt;weight&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游太多、無法一一設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy.discovery]&lt;/code&gt;：依 realm 查 DNS 找出對方的 RadSec 伺服器&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游都沒回應時，轉送的計費不能遺失&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy.accounting_spool]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;對方也要把請求送進來&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.tls]&lt;/code&gt;，見&lt;a class=&#34;link&#34; href=&#34;../10-radsec/&#34; &gt;第 10 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帶 realm 的本地帳號被轉出去&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;有 &lt;code&gt;*&lt;/code&gt; 或涵蓋自己網域的 &lt;code&gt;*.&lt;/code&gt; 項目&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;轉送的登入每次都很慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;第一台上游一直沒回應，但 Status-Server 確認時又有回應（上游回 Status-Server 但不處理認證），可以把它從 &lt;code&gt;servers&lt;/code&gt; 拿掉，或設 &lt;code&gt;status_check = false&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;錯誤密碼的登入之後，上游被判定停擺&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;timeout_ms&lt;/code&gt; 比上游延遲拒絕的時間短&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec 上游一直連不上，log 有 &lt;code&gt;cannot connect ... TLS:&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;對方憑證不是 &lt;code&gt;ca_file&lt;/code&gt; 的 CA 簽的、對 &lt;code&gt;tls_name&lt;/code&gt; 無效，或對方不接受 rradius 出示的憑證（沒設 &lt;code&gt;cert_file&lt;/code&gt;、或不是對方信任的 CA 簽的）。log 的訊息會說是哪一種&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec 上游連上了但每個請求都逾時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼不是 &lt;code&gt;radsec&lt;/code&gt;，對方的回應驗證不過：問對方用的密碼，設在 &lt;code&gt;secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>10. RadSec：NAS 經過不信任的網路</title>
            <link>https://embark.systems/rradius/10-radsec/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/10-radsec/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; NAS 和 rradius 之間隔著網際網路，或一段你不信任的網路。RADIUS 的 UDP 只用共用密碼和 MD5 保護一部分內容，不適合直接走這種網路。改用 RadSec（RADIUS over TLS，RFC 6614）：整個封包都在 TLS 裡，雙方用憑證確認彼此。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;總部的無線控制器&lt;/strong&gt; 位址固定，用憑證加位址辨認。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;分店的閘道&lt;/strong&gt; 在 NAT 後面，沒有固定位址，只靠憑證辨認。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;要踢分店的使用者時，&lt;/strong&gt; rradius 連不到 NAT 後面的閘道，所以請求走閘道自己連進來的那條 RadSec 連線。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;總部的管理系統&lt;/strong&gt; 也經 RadSec 連進來，在同一條連線上送踢人的請求。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/radsec/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.tls]&lt;/code&gt;、三種 client、&lt;code&gt;[radius.coa]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;make-certs.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;產生示範用的 CA、伺服器憑證和三張用戶端憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號（結構同快速開始）和示範帳號 alice&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;hq-wlc.secret&lt;/code&gt;、&lt;code&gt;helpdesk.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;控制器走 UDP 時的共用密碼、客服系統送 CoA 的共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;和-udp-的差別&#34;&gt;和 UDP 的差別&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;UDP&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;RadSec&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;埠&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;認證 1812、計費 1813&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;一個 TCP 埠 2083，認證、計費、Status-Server 共用一條連線&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;怎麼認得 NAS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址、憑證，或兩者&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每台 NAS 自己的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;固定是 &lt;code&gt;radsec&lt;/code&gt;（RFC 規定），保護靠 TLS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Message-Authenticator 的設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;適用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不適用，完整性由 TLS 保障&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;連進來之後，請求走的路和 UDP 完全相同：同樣的認證串接、腳本、EAP、依 realm 轉送和計費暫存。&lt;/p&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-產生憑證&#34;&gt;1. 產生憑證&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server/examples/scenarios/radsec&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./make-certs.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;certs/&lt;/code&gt; 裡會有 &lt;code&gt;ca.pem&lt;/code&gt;、伺服器的 &lt;code&gt;server.pem&lt;/code&gt;／&lt;code&gt;server.key&lt;/code&gt;（名稱 &lt;code&gt;radius.example.net&lt;/code&gt;），和三張用戶端憑證：&lt;code&gt;hq-wlc&lt;/code&gt;、&lt;code&gt;branch-gw&lt;/code&gt;、&lt;code&gt;noc&lt;/code&gt;。&lt;strong&gt;只供測試。&lt;/strong&gt; 正式環境請用專門簽發給 NAS 的私有 CA（見下方「上線前」）。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-啟動&#34;&gt;2. 啟動&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd ../../..   &lt;span style=&#34;color:#75715e&#34;&gt;# 回到 rradius-server&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/radsec/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;記錄會有 &lt;code&gt;RadSec listening on 0.0.0.0:2083&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-確認握手&#34;&gt;3. 確認握手&#xA;&lt;/h3&gt;&lt;p&gt;還沒有 NAS 時，先用 &lt;code&gt;openssl&lt;/code&gt; 拿分店閘道的憑證連一次，確認憑證這一段是通的：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd examples/scenarios/radsec&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;openssl s_client -connect 127.0.0.1:2083 -servername radius.example.net &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  -CAfile certs/ca.pem -cert certs/branch-gw.pem -key certs/branch-gw.key&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;看到 &lt;code&gt;Verify return code: 0 (ok)&lt;/code&gt; 就是雙方的憑證都通過了。按 Ctrl+C 結束。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;curl -s http://127.0.0.1:9812/metrics | grep rradius_radsec_connections&lt;/code&gt; 的 &lt;code&gt;result=&amp;quot;accepted&amp;quot;&lt;/code&gt; 會加 1。&lt;/li&gt;&#xA;&lt;li&gt;換成 &lt;code&gt;hq-wlc&lt;/code&gt; 的憑證再連一次：握手會成功，但連線馬上被關閉，記錄寫 &lt;code&gt;its certificate fits no client&lt;/code&gt;。原因是 &lt;code&gt;hq-wlc&lt;/code&gt; 這個 client 有 &lt;code&gt;address&lt;/code&gt;，只接受從 &lt;code&gt;10.30.0.10&lt;/code&gt; 來的連線，而其他只靠憑證辨認的 client 都不是這個名稱。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;code&gt;openssl&lt;/code&gt; 只能確認握手。真正的登入要由會講 RadSec 的 NAS 或代理送出；自動測試用程式做了這一段：以 &lt;code&gt;branch-gw&lt;/code&gt; 的憑證連線，登入 alice（Access-Accept，帶 &lt;code&gt;Filter-Id = &amp;quot;staff&amp;quot;&lt;/code&gt;）並送計費。&lt;/p&gt;&#xA;&lt;h3 id=&#34;4-nas-的設定&#34;&gt;4. NAS 的設定&#xA;&lt;/h3&gt;&lt;p&gt;每台 NAS 的設定方式不同，要設定的項目是同一組：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;項目&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;值&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;伺服器位址和埠&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;rradius 的位址，TCP 2083&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;傳輸方式&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec、RADIUS over TLS，或「TLS」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;信任的 CA&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;簽發 rradius 伺服器憑證的 CA（範例的 &lt;code&gt;ca.pem&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;伺服器名稱&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;伺服器憑證上的名稱（範例的 &lt;code&gt;radius.example.net&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用戶端憑證和私鑰&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這台 NAS 自己的（範例的 &lt;code&gt;branch-gw.pem&lt;/code&gt;、&lt;code&gt;branch-gw.key&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;radsec&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;tls&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;bind&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;0.0.0.0&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;2083&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cert_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/server.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/server.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;client_ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;min_tls_version&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;1.2&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;network_clients_need_tls_name&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;client_ca_file&lt;/code&gt; 是簽發 NAS 憑證的 CA。&lt;/strong&gt; rradius 只信任它，不信任系統的根憑證。沒有憑證、或憑證不是它簽的 NAS，握手就失敗。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;min_tls_version&lt;/code&gt;&lt;/strong&gt; 預設 &lt;code&gt;&amp;quot;1.2&amp;quot;&lt;/code&gt;。所有 NAS 都支援 TLS 1.3 時可以改成 &lt;code&gt;&amp;quot;1.3&amp;quot;&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;[radius]&lt;/code&gt; 一定要有，&lt;/strong&gt; RadSec 是它底下的一個區段。UDP 的 1812、1813 照常開著；不想讓 UDP 從外面連進來，用防火牆擋。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;三種-client&#34;&gt;三種 client&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;hq-wlc&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.30.0.10&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;hq-wlc.example.net&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;hq-wlc.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;branch-gw&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;branch-gw.example.net&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;unused-on-radsec-change-me&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;max_radsec_connections&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;4&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;設定&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;怎麼比對&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;適合&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只有 &lt;code&gt;address&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址。同一個 CA 簽的任何憑證都能當成這個 client&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CA 只簽給 NAS、位址固定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;address&lt;/code&gt; 加 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址，而且憑證要對這個名稱有效&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;位址固定的 NAS，範例的 &lt;code&gt;hq-wlc&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只有 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;憑證要對這個名稱有效，來源是其他項目都沒涵蓋的位址&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAT 後面、位址會變的 NAS，範例的 &lt;code&gt;branch-gw&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;tls_name&lt;/code&gt; 比對憑證的 DNS SAN，&lt;/strong&gt; 憑證上的萬用字元也算；不看 CN。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;來源位址優先。&lt;/strong&gt; 來源落在某個有 &lt;code&gt;address&lt;/code&gt; 的項目內，就由那個項目處理，憑證不會把連線移到別的 client。所以只靠憑證辨認的 NAS，來源不能落在其他 client 的網段裡。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;secret&lt;/code&gt; 仍然必填。&lt;/strong&gt; RadSec 用不到它；有 &lt;code&gt;address&lt;/code&gt; 的 client 走 UDP 時才用。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只有 &lt;code&gt;tls_name&lt;/code&gt; 的 client 只能走 RadSec，&lt;/strong&gt; UDP 比對不到它。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;max_radsec_connections&lt;/code&gt;&lt;/strong&gt; 限制這個 client 最多同時開幾條連線。沒設時，一張憑證可以占滿 &lt;code&gt;[radius.tls]&lt;/code&gt; 的 &lt;code&gt;max_connections&lt;/code&gt;（預設 1024）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;網段 client 要小心。&lt;/strong&gt; &lt;code&gt;address&lt;/code&gt; 是網段又沒有 &lt;code&gt;tls_name&lt;/code&gt; 時，網段裡任何位址拿這個 CA 的任何憑證都能連。範例設了 &lt;code&gt;network_clients_need_tls_name = true&lt;/code&gt;，這種 client 就不接受 RadSec 連線（照樣可以走 UDP）。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;腳本知道是哪台-nas&#34;&gt;腳本知道是哪台 NAS&#xA;&lt;/h3&gt;&lt;p&gt;請求走 RadSec 時，腳本可以讀連線的憑證：&lt;code&gt;radsec_subject&lt;/code&gt; 是主體的文字，&lt;code&gt;radsec_subject_attrs.CN[1]&lt;/code&gt; 是其中一個欄位。它說的是 &lt;strong&gt;NAS 是誰&lt;/strong&gt;，不是使用者是誰。UDP 的請求和重放的計費是 &lt;code&gt;nil&lt;/code&gt;。見 usage 4.2 節。&lt;/p&gt;&#xA;&lt;h2 id=&#34;踢人請求走-nas-自己的連線&#34;&gt;踢人：請求走 NAS 自己的連線&#xA;&lt;/h2&gt;&lt;p&gt;分店閘道在 NAT 後面，rradius 沒有位址可以送 Disconnect-Request。只有 &lt;code&gt;tls_name&lt;/code&gt; 的 client 有連線開著時，rradius 改在&lt;strong&gt;它連進來的那條 RadSec 連線&lt;/strong&gt;上送。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;coa_timeout_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;2000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;coa&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;bind&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;0.0.0.0&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;3799&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;coa&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;helpdesk&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.30.0.50&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;helpdesk.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;客服系統（&lt;code&gt;helpdesk&lt;/code&gt;）用 UDP 把請求送到 rradius 的 3799 埠，用 &lt;code&gt;NAS-Identifier&lt;/code&gt; 指出是哪台 NAS：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=alice,NAS-Identifier=branch-gw,Acct-Session-Id=rs-1&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  | radclient 127.0.0.1:3799 disconnect helpdesk-coa-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;（本機測試時先把 &lt;code&gt;helpdesk&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。）&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;怎麼找 NAS：&lt;/strong&gt; 依序用請求裡的 &lt;code&gt;NAS-IP-Address&lt;/code&gt;、&lt;code&gt;NAS-IPv6-Address&lt;/code&gt;、&lt;code&gt;NAS-Identifier&lt;/code&gt; 比對 client 的位址或 &lt;code&gt;name&lt;/code&gt;。&lt;code&gt;branch-gw&lt;/code&gt; 沒有位址，所以用名稱。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;在連線上只送一次，&lt;/strong&gt; 等 &lt;code&gt;coa_timeout_ms&lt;/code&gt;。TCP 不會掉封包，所以不看 &lt;code&gt;coa_attempts&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;閘道沒有連線開著時，&lt;/strong&gt; 回 NAK，&lt;code&gt;Error-Cause&lt;/code&gt; 是 502（Request Not Routable）。上面的指令在沒有閘道連著時就會得到這個結果。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;NAS 要願意在自己開的連線上收 Disconnect 和 CoA。&lt;/strong&gt; 不是每台設備都支援，先向廠商確認。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;腳本也可以送：&lt;/strong&gt; &lt;code&gt;send_disconnect(&#39;branch-gw&#39;, {...})&lt;/code&gt; 走同一條連線。沒有連線時腳本會出錯。命令列的 &lt;code&gt;rradius-server disconnect&lt;/code&gt; 不在伺服器裡執行，拿不到連線，所以不能以這種 client 為目標。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;叢集裡只有握著那條連線的節點送得出去。&lt;/strong&gt; 閘道連到 node1 時，請求要送給 node1；送到別的節點會得到 502。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;管理系統也走-radseccoa_sender&#34;&gt;管理系統也走 RadSec：&lt;code&gt;coa_sender&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;noc&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;noc.example.net&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;unused-on-radsec-change-me&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;coa_sender&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;送出端本來就經 RadSec 連到 rradius 時，設 &lt;code&gt;coa_sender = true&lt;/code&gt;，它就能在同一條連線上送 Disconnect-Request 和 CoA-Request，不必另外開 UDP、設共用密碼。回答寫回同一條連線。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;預設關閉。&lt;/strong&gt; 送出端和 NAS 共用 2083 埠，防火牆分不開兩者，只能靠這個設定決定誰可以讓使用者斷線。沒設的 client 送來時丟棄，記錄 &lt;code&gt;is not a coa_sender&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;需要 &lt;code&gt;[radius.coa]&lt;/code&gt; 和 &lt;code&gt;[radius.tls]&lt;/code&gt;。&lt;/strong&gt; 只經 RadSec 收的話，&lt;code&gt;[[radius.coa.clients]]&lt;/code&gt; 可以不寫，但 3799 的 UDP 埠照樣會開。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;完整的規則（只給使用者名稱時查 session、依 realm 轉給上游、各種 NAK）見&lt;a class=&#34;link&#34; href=&#34;../07-broadband/#coa-%e8%bd%89%e9%80%81&#34; &gt;第 7 章&lt;/a&gt;和 usage 4.8 節。&lt;/p&gt;&#xA;&lt;h2 id=&#34;撤銷一台-nas&#34;&gt;撤銷一台 NAS&#xA;&lt;/h2&gt;&lt;p&gt;三種做法，由快到慢：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&lt;strong&gt;拿掉它的 &lt;code&gt;[[radius.clients]]&lt;/code&gt; 項目，送 SIGHUP。&lt;/strong&gt; 已開啟的連線收到下一個封包時就關閉。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;撤銷憑證：&lt;/strong&gt; 設 &lt;code&gt;crl_file&lt;/code&gt;，把新的撤銷清單放上去再送 SIGHUP。之後這張憑證握不了手，已開啟的連線也會在重新檢查時關閉（SIGHUP 當下，和之後每分鐘一次）。撤銷清單要涵蓋憑證鏈上每一層 CA，缺一層就會擋下所有設備。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;CA 只提供 OCSP 時&lt;/strong&gt; 設 &lt;code&gt;ocsp&lt;/code&gt;，做法和 EAP-TLS 相同，見&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/#ocspca-%e4%b8%8d%e7%99%bc%e6%92%a4%e9%8a%b7%e6%b8%85%e5%96%ae%e6%99%82&#34; &gt;第 15 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;CA 只簽給 NAS。&lt;/strong&gt; &lt;code&gt;client_ca_file&lt;/code&gt; 的 CA 也簽使用者的 EAP-TLS 憑證時，使用者的憑證就能拿來當 NAS 連進來（只有 &lt;code&gt;address&lt;/code&gt; 的 client 擋不住）。用另一個 CA，或每個 client 都設 &lt;code&gt;tls_name&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;用防火牆限制 2083 的來源。&lt;/strong&gt; 有只靠憑證辨認的 client 時，握手前不能用來源位址擋下陌生連線，任何連得到這個埠的人都能消耗 TLS 握手。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;憑證到期前要換。&lt;/strong&gt; 過期的憑證握不了手，已開啟的連線最多再多開一分鐘。伺服器的憑證換好後送 SIGHUP，新連線用新的，已開啟的不受影響。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;放在負載平衡器後面&lt;/strong&gt; 時，負載平衡器要用 TCP 模式並送 PROXY protocol 標頭，位址列在 &lt;code&gt;proxy_protocol_from&lt;/code&gt;；TLS 仍由 rradius 處理。見 usage 2.7 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;同一個埠給不同的名稱不同的憑證&lt;/strong&gt;（多租戶）用 &lt;code&gt;[[radius.tls.certificates]]&lt;/code&gt;，見同一節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;閒置的連線&lt;/strong&gt; 300 秒沒有完整封包就關閉（&lt;code&gt;idle_timeout_ms&lt;/code&gt;），NAS 會重新連線。NAS 定期送 Status-Server 就不會被關。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有測過的：&lt;/strong&gt; 任何實體 NAS 的 RadSec。互通測試用 FreeRADIUS 3.2.10 當代理測過認證、計費和 CoA。在 NAS 自己的連線上送 CoA 只用程式模擬的 NAS 測過。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;RadSec handshake with ... failed&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 沒有出示憑證、憑證不是 &lt;code&gt;client_ca_file&lt;/code&gt; 簽的、已被撤銷，或 TLS 版本不合&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;RadSec connection from unknown client&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源不在任何 client 的位址裡，也沒有只靠憑證辨認的 client&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;握手成功但馬上斷線，&lt;code&gt;its certificate fits no client&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;憑證的名稱不是任何只有 &lt;code&gt;tls_name&lt;/code&gt; 的 client；或來源落在某個有 &lt;code&gt;address&lt;/code&gt; 的 client 裡，而憑證對它的 &lt;code&gt;tls_name&lt;/code&gt; 無效（這時訊息是 &lt;code&gt;is not valid for client ...&#39;s tls_name&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;has no tls_name, which network_clients_need_tls_name asks for&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;網段 client 沒有 &lt;code&gt;tls_name&lt;/code&gt;，又開了 &lt;code&gt;network_clients_need_tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連上了，但每個請求都沒有回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 的共用密碼不是 &lt;code&gt;radsec&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;踢人回 502&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;NAS-Identifier&lt;/code&gt; 不是 client 的 &lt;code&gt;name&lt;/code&gt;、那台 NAS 沒有連線開著，或它連在別的節點&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;踢人回 505&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 在 &lt;code&gt;coa_timeout_ms&lt;/code&gt; 內沒有回答：它不支援在這條連線上收 CoA&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連線每 5 分鐘斷一次&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;閒置逾時，調高 &lt;code&gt;idle_timeout_ms&lt;/code&gt; 或讓 NAS 送 Status-Server&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>11. 漫遊聯盟（eduroam 這一類）</title>
            <link>https://embark.systems/rradius/11-roaming/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/11-roaming/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 一所學校（範例的 realm 是 &lt;code&gt;uni-a.example&lt;/code&gt;）加入漫遊聯盟。聯盟的成員互相承認帳號：任何成員的使用者到了別的成員那裡，都能用自己學校的帳號連上 Wi-Fi。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;本校的人在本校：&lt;/strong&gt; &lt;code&gt;student1@uni-a.example&lt;/code&gt; 在本機認證。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;外校的人來訪：&lt;/strong&gt; &lt;code&gt;bob@uni-b.example&lt;/code&gt; 轉給他自己的學校。成員太多，無法一一設定，所以依 realm 查 DNS 找出對方的伺服器；查不到的交給全國代理。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;本校的人到外校：&lt;/strong&gt; 請求從聯盟經 RadSec 送回來，由本機認證。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;姊妹校&lt;/strong&gt; 在同一條專線上，有兩台伺服器，要把使用者分攤過去。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;上游都停擺時，&lt;/strong&gt; 轉送的計費不能遺失。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這一章接在&lt;a class=&#34;link&#34; href=&#34;../09-realm-proxy/&#34; &gt;第 9 章&lt;/a&gt;（依 realm 轉送的基本做法）和&lt;a class=&#34;link&#34; href=&#34;../10-radsec/&#34; &gt;第 10 章&lt;/a&gt;（RadSec）之後，那兩章講過的不再重複。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/roaming/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy]&lt;/code&gt;、&lt;code&gt;[proxy.discovery]&lt;/code&gt;、&lt;code&gt;[proxy.accounting_spool]&lt;/code&gt;、&lt;code&gt;[radius.tls]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;make-certs.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;產生示範用的聯盟 CA、本校的 RadSec 憑證、一張假裝是全國代理的憑證，和 PEAP 用的伺服器憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;本校的帳號（結構同快速開始）和示範帳號 student1&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;wlc.secret&lt;/code&gt;、&lt;code&gt;uni-b.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;校園控制器、姊妹校的共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;一個請求往哪裡去&#34;&gt;一個請求往哪裡去&#xA;&lt;/h2&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;student1                    沒有 @ ─────────────────────────────► 本機&#xA;student1@uni-a.example      在 local_realms ────────────────────► 本機&#xA;bob@uni-b.example           [[proxy.realms]] 完全相同 ──────────► uni-b-1、uni-b-2（分攤）&#xA;carol@dept.gov.example      [[proxy.realms]] 的 *.gov.example ──► 全國代理&#xA;dave@uni-c.example          沒有項目 → 查 DNS ─┬─ 查到 ────────► uni-c 自己的 RadSec 伺服器&#xA;                                               ├─ DNS 說沒有 ──► [[proxy.realms]] 的 * → 全國代理&#xA;                                               └─ 查詢失敗 ────► 丟棄，NAS 重送時再查&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;順序：&lt;/strong&gt; 完全相同的 realm → 涵蓋它的 &lt;code&gt;*.&lt;/code&gt; 項目 → &lt;code&gt;local_realms&lt;/code&gt; → DNS → &lt;code&gt;*&lt;/code&gt;。&lt;code&gt;*&lt;/code&gt; 只在 DNS 明確說「沒有」時才用。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;轉送的請求不在本機處理。&lt;/strong&gt; 802.1X 的整段 EAP 對話原樣轉給對方，密碼和金鑰都由對方處理，本機看不到密碼。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;本機的 &lt;code&gt;[radius.eap]&lt;/code&gt;&lt;/strong&gt; 只服務留在本機的請求（本校的使用者）。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-產生憑證並啟動&#34;&gt;1. 產生憑證並啟動&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server/examples/scenarios/roaming&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./make-certs.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd ../../..&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --check --config examples/scenarios/roaming/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;--check&lt;/code&gt; 會確認每台上游的憑證讀得到、私鑰和憑證配對。&lt;strong&gt;範例的上游位址都是文件用的假位址，&lt;/strong&gt; 啟動後本校的帳號可以登入，轉送的請求不會有回應。要在本機看到轉送，照&lt;a class=&#34;link&#34; href=&#34;../09-realm-proxy/#%e6%ad%a5%e9%a9%9f&#34; &gt;第 9 章的步驟&lt;/a&gt;另開一份快速開始當姊妹校，把 &lt;code&gt;uni-b-1&lt;/code&gt;、&lt;code&gt;uni-b-2&lt;/code&gt; 指過去。&lt;/p&gt;&#xA;&lt;p&gt;本機測試時，把 &lt;code&gt;campus-wlc&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/roaming/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest Student1@uni-a.example student1-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; campus-wlc-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;會收到 Access-Accept，帶 &lt;code&gt;Filter-Id = &amp;quot;campus&amp;quot;&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-正式環境要換掉的&#34;&gt;2. 正式環境要換掉的&#xA;&lt;/h3&gt;&lt;ol&gt;&#xA;&lt;li&gt;&lt;strong&gt;向聯盟申請 RadSec 憑證，&lt;/strong&gt; 並拿到聯盟的 CA。取代 &lt;code&gt;certs/radius.pem&lt;/code&gt;、&lt;code&gt;certs/radius.key&lt;/code&gt;、&lt;code&gt;certs/federation-ca.pem&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;local_realms&lt;/code&gt;、&lt;code&gt;[[radius.clients]]&lt;/code&gt; 的全國代理名稱、&lt;code&gt;flr-1&lt;/code&gt;／&lt;code&gt;flr-2&lt;/code&gt; 的位址和 &lt;code&gt;tls_name&lt;/code&gt;&lt;/strong&gt; 換成聯盟給的值。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;[radius.eap]&lt;/code&gt; 的憑證&lt;/strong&gt; 換成你要給自己的使用者看的那一張，見&lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/&#34; &gt;第 3 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;在 DNS 發布自己的 NAPTR 和 SRV 記錄，&lt;/strong&gt; 別的成員才找得到你。記錄的格式由聯盟規定。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;h3 id=&#34;依-dns-找對方的伺服器&#34;&gt;依 DNS 找對方的伺服器&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;discovery&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/federation-ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cert_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/radius.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/radius.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;service&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;x-eduroam:radius.tls&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;local_realms&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-a.example&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;*.uni-a.example&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lookup_timeout_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;5000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;realm_names_only&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;probe_interval_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;30000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;沒有 &lt;code&gt;[[proxy.realms]]&lt;/code&gt; 項目的 realm 會查 DNS（RFC 7585）：先查 realm 的 NAPTR 記錄，取 &lt;code&gt;service&lt;/code&gt; 相符的，再查它指向的 SRV 記錄和主機位址，最多取 8 個位址。找到的伺服器一律用 RadSec，依 DNS 給的順序容錯。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;local_realms&lt;/code&gt; 一定要列自己的 realm。&lt;/strong&gt; 聯盟成員通常也替自己的 realm 發布 NAPTR；沒列的話，自己的使用者會被查到自己的 RadSec 伺服器，轉出去再繞回來，進不了本機的 EAP 和串接。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;service&lt;/code&gt;&lt;/strong&gt; 預設是 RFC 7585 的 &lt;code&gt;aaa+auth:radius.tls.tcp&lt;/code&gt;，eduroam 用 &lt;code&gt;x-eduroam:radius.tls&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;ca_file&lt;/code&gt; 是聯盟的 CA，&lt;/strong&gt; 對方的憑證要由它簽發。&lt;code&gt;cert_file&lt;/code&gt;、&lt;code&gt;key_file&lt;/code&gt; 是出示給對方的憑證，多數聯盟要求雙向驗證。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;realm_names_only = true&lt;/code&gt;：&lt;/strong&gt; 對方的憑證一定要對 &lt;strong&gt;realm 本身&lt;/strong&gt; 有效（DNS 名稱，或 NAIRealm 欄位）。設成 &lt;code&gt;false&lt;/code&gt;（預設）時，對 SRV 記錄指向的主機名稱有效也算。差別在於：rradius 不做 DNSSEC，主機名稱來自沒有驗證的 DNS 回答，所以 &lt;code&gt;false&lt;/code&gt; 時，能竄改 DNS 又持有聯盟任何一張憑證的人（例如另一個成員），可以把別的 realm 的請求導到自己那裡。聯盟的憑證上有 realm 名稱時就打開；聯盟只發主機名稱的憑證時，打開會連不上。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;lookup_timeout_ms&lt;/code&gt;：&lt;/strong&gt; 一個 realm 整段查詢最多等這麼久。realm 來自使用者輸入的名稱，DNS 記錄由那個網域的擁有者決定，所以查詢有上限：每個節點同時最多 16 個查詢，同一個 realm 同時只查一次。正在查或名額用完時，這個請求直接丟棄，NAS 重送時多半已經查好。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;結果會記住：&lt;/strong&gt; 查到的依 DNS 的 TTL 保留（至少 60 秒、最多一天）；DNS 說沒有的記 5 分鐘；最多記 4,096 個 realm。SIGHUP 時清空。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;查詢失敗不等於沒有。&lt;/strong&gt; 逾時、SERVFAIL、DNS 伺服器連不到時：&#xA;&lt;ul&gt;&#xA;&lt;li&gt;這個 realm 以前查到過，就繼續用上次的伺服器，30 秒後再查。&lt;/li&gt;&#xA;&lt;li&gt;以前沒查到過，這個 realm 的請求丟棄 30 秒，&lt;strong&gt;不會改送 &lt;code&gt;*&lt;/code&gt;，也不會留在本機&lt;/strong&gt;。送錯地方的計費會被別人記帳，所以寧可不回應。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;probe_interval_ms&lt;/code&gt;：&lt;/strong&gt; 找到的伺服器閒置這麼久，就送 Status-Server 確認它還在。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;全國代理&#34;&gt;全國代理&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr-1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;198.51.100.1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;transport&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;tls&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr1.roam.example&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/federation-ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cert_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/radius.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/radius.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;probe_interval_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;30000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;realms&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;*.gov.example&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr-1&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr-2&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;realms&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;*&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr-1&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr-2&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;*&lt;/code&gt; 是 DNS 查不到時的出口。&lt;/strong&gt; 沒有發布 DNS 記錄的成員就靠全國代理轉送。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;已知沒有 DNS 記錄的單位，直接列出來&lt;/strong&gt;（範例的 &lt;code&gt;*.gov.example&lt;/code&gt;），省掉每 5 分鐘一次的查詢。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;probe_interval_ms&lt;/code&gt;（主動檢查）：&lt;/strong&gt; 沒設時，上游只在真的請求逾時後才被判定停擺。備援的 &lt;code&gt;flr-2&lt;/code&gt; 平常沒有流量，等主機掛了才發現它也掛了就太晚。設了之後，上游超過這段時間沒有任何回應，就送一次 Status-Server；連續 3 次沒回應判定停擺，&lt;code&gt;rradius_proxy_server_alive&lt;/code&gt; 變成 0，可以拿來告警。有流量的上游不會多收任何封包。上游要會回答 Status-Server。&lt;/li&gt;&#xA;&lt;li&gt;RadSec 上游的其他規則（一條長連線、不重送、同時 256 個請求）見&lt;a class=&#34;link&#34; href=&#34;../09-realm-proxy/#%e8%b7%a8%e7%b5%84%e7%b9%94%e6%bc%ab%e9%81%8aradsec-%e4%b8%8a%e6%b8%b8&#34; &gt;第 9 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;聯盟連進來&#34;&gt;聯盟連進來&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;tls&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;2083&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cert_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/radius.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/radius.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;client_ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/federation-ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;network_clients_need_tls_name&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr-1-in&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;flr1.roam.example&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;unused-on-radsec-change-me&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;本校的人在外校登入時，請求經全國代理送到這裡的 2083 埠。全國代理只靠憑證辨認（只有 &lt;code&gt;tls_name&lt;/code&gt;），它們的位址換了也不用改設定。進來的請求名稱是 &lt;code&gt;student1@uni-a.example&lt;/code&gt;，在 &lt;code&gt;local_realms&lt;/code&gt; 裡，所以留在本機，由 &lt;code&gt;[radius.eap]&lt;/code&gt; 和串接處理。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;直接連進來的其他成員：&lt;/strong&gt; 別的成員用 DNS 找到你時，會直接連你的 2083 埠，不經過全國代理。連進來的對端要符合某個 &lt;code&gt;[[radius.clients]]&lt;/code&gt; 項目，否則握手後就被關閉。兩種做法：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;每個對端一個項目，&lt;/strong&gt; &lt;code&gt;tls_name&lt;/code&gt; 是它憑證上的名稱。最嚴格，但成員很多時列不完，可以請對方經全國代理送來。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;一個涵蓋對端位址範圍的網段項目，不設 &lt;code&gt;tls_name&lt;/code&gt;。&lt;/strong&gt; 這個網段裡拿聯盟 CA 任何一張憑證的對端都能連進來（&lt;a class=&#34;link&#34; href=&#34;../10-radsec/#%e4%b8%89%e7%a8%ae-client&#34; &gt;第 10 章的表&lt;/a&gt;）。這時不能開 &lt;code&gt;network_clients_need_tls_name&lt;/code&gt;，啟動時會有一行警告；這個網段用 UDP 也進得來（靠 &lt;code&gt;secret&lt;/code&gt;），所以 &lt;code&gt;secret&lt;/code&gt; 要用夠長的隨機值，並用防火牆擋掉它的 UDP。範例沒有這樣設，情境測試也沒有涵蓋這個做法。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;分攤到多台上游&#34;&gt;分攤到多台上游&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-b-1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.41.0.1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-b.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;weight&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-b-2&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.41.0.2&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-b.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;weight&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;3&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;realms&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-b.example&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;servers&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-b-1&amp;#34;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;uni-b-2&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;balance&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;load-balance&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;strip_realm&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;balance = &amp;quot;load-balance&amp;quot;&lt;/code&gt;：&lt;/strong&gt; 預設的 &lt;code&gt;failover&lt;/code&gt; 都先送第一台。改成 &lt;code&gt;load-balance&lt;/code&gt; 後，每個請求依 &lt;code&gt;Calling-Station-Id&lt;/code&gt; 和 &lt;code&gt;User-Name&lt;/code&gt; 算出一個固定的順序，先送排第一的那台。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;同一台設備一直到同一台上游：&lt;/strong&gt; EAP 整段對話的每個請求，和同一個 session 的計費 Start、Interim-Update、Stop 都會到同一台，不需要另外設定。每個節點、每次重啟算出的結果都相同。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;weight&lt;/code&gt;：&lt;/strong&gt; 分到的比例和它成正比，範例的 &lt;code&gt;uni-b-2&lt;/code&gt; 分到約四分之三。只有 &lt;code&gt;load-balance&lt;/code&gt; 會看它。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;一台停擺時，&lt;/strong&gt; 只有原本排它第一的設備換台，其他設備不受影響。換台的設備正在進行的 EAP 對話會失敗，NAS 會重新開始。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;使用者很少時可能偏向一台，&lt;/strong&gt; 因為分配取決於名稱和 MAC 的分布。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;自動測試用 24 台不同 MAC 的設備登入同一個帳號：兩台上游都收到請求，&lt;code&gt;weight = 3&lt;/code&gt; 的那台收到比較多。&lt;/p&gt;&#xA;&lt;h3 id=&#34;上游全掛時暫存計費&#34;&gt;上游全掛時暫存計費&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;proxy&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;accounting_spool&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;dir&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;spool/proxy&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;replay_interval_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;5000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;replay_window&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;32&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;沒有這個區段時，轉送的計費在所有上游都沒回應時不回覆，NAS 重送幾次後就遺失。設定後：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;realm 的每台上游都沒有回應時，請求先寫到本機的 &lt;code&gt;dir&lt;/code&gt;，落盤後回覆 NAS。&lt;/li&gt;&#xA;&lt;li&gt;背景工作從最舊的開始再送，一次最多同時送 &lt;code&gt;replay_window&lt;/code&gt; 筆，&lt;code&gt;Acct-Delay-Time&lt;/code&gt; 會加上等待的時間。上游還是沒回應時，隔 &lt;code&gt;replay_interval_ms&lt;/code&gt; 再試。&lt;/li&gt;&#xA;&lt;li&gt;上游回應後，這一筆才算完成。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;只暫存計費。&lt;/strong&gt; 登入要即時的答案，上游沒回應時不回覆，讓 NAS 改用它的備援。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;至少一次：&lt;/strong&gt; 程序在上游回應和記錄進度之間中斷時，同一筆會再送一次。上游要能容忍重複，通常用 &lt;code&gt;Acct-Session-Id&lt;/code&gt; 判斷。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;順序：&lt;/strong&gt; 同一批裡，同一個 session 的 Start 和 Stop 可能顛倒到達。上游要求嚴格順序時設 &lt;code&gt;replay_window = 1&lt;/code&gt;，代價是重送變慢。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;所有 realm 共用一個佇列。&lt;/strong&gt; 一個 realm 的上游一直不回應時，其他 realm 暫存的計費也要等。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;拿掉 realm 前先確認暫存是空的。&lt;/strong&gt; SIGHUP 拿掉某個 realm 時，它還沒送出的計費會移到 &lt;code&gt;rejected.log&lt;/code&gt;。看 &lt;code&gt;rradius_proxy_acct_spool_bytes&lt;/code&gt; 是不是 0。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;和本機計費的暫存分開：&lt;/strong&gt; &lt;code&gt;[radius.accounting_spool]&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../07-broadband/#%e8%a8%88%e8%b2%bb%e6%9a%ab%e5%ad%98&#34; &gt;第 7 章&lt;/a&gt;）管的是寫不進資料庫的計費，兩個目錄不能相同，互不影響。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;改這個區段要重啟。&lt;/strong&gt; 檔案含使用者名稱等個人資料，放在持久的磁碟上。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;監控：&lt;/strong&gt; &lt;code&gt;rradius_proxy_server_alive&lt;/code&gt;（0 就告警）、&lt;code&gt;rradius_proxy_acct_spool_bytes&lt;/code&gt;（持續大於 0 代表上游還沒恢復）、&lt;code&gt;rradius_proxy_unanswered_total&lt;/code&gt;（沒有任何上游回應的請求）。DNS 找到的伺服器也在這些指標裡，&lt;code&gt;server&lt;/code&gt; 標籤是 &lt;code&gt;realm 主機:位址:埠&lt;/code&gt;；聯盟很大時時間序列會很多。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;時間要算好：&lt;/strong&gt; 每台 UDP 上游最多等 &lt;code&gt;timeout_ms × attempts&lt;/code&gt;，RadSec 上游等一次 &lt;code&gt;timeout_ms&lt;/code&gt;，第一次查某個 realm 還要加上 DNS 的時間。總和要比 NAS 的逾時短。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;匿名的外層名稱：&lt;/strong&gt; 使用者的外層名稱通常是 &lt;code&gt;anonymous@uni-b.example&lt;/code&gt;。轉送只看 realm，所以沒有影響；但 &lt;code&gt;load-balance&lt;/code&gt; 用外層名稱加 MAC 分配，同一個 realm 的匿名使用者靠 MAC 分開。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;CoA 依 realm 轉給上游時，&lt;/strong&gt; 只用有名稱的 realm 項目，不用 &lt;code&gt;*&lt;/code&gt;，也不用 DNS 找到的伺服器。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有測過的：&lt;/strong&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;依 DNS 找上游，沒有接上真的聯盟。&lt;/strong&gt; 名稱比對、快取和轉送用模擬的 DNS 測過；查詢本身用公開的 DNS 查過一個 eduroam 成員的記錄。自動測試沒有 DNS，所以這一段不在情境測試裡。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;暫存的計費在上游恢復後重送，&lt;/strong&gt; 情境測試只確認了「寫入暫存並回覆 NAS」，重送由專案的其他測試涵蓋。&lt;/li&gt;&#xA;&lt;li&gt;情境測試確認了：本校的 realm 留在本機、&lt;code&gt;*.gov.example&lt;/code&gt; 經 RadSec 送到上游、姊妹校依比重分攤、上游全掛時計費有回覆、全國代理經 RadSec 連進來。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;自己的使用者登入沒有回應，記錄有 &lt;code&gt;came back to this server&lt;/code&gt;，或連自己的 2083 埠被關閉&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;自己的 realm 沒有列在 &lt;code&gt;local_realms&lt;/code&gt;，被查到自己的伺服器，轉了出去&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某個 realm 的請求都沒有回應，記錄有 &lt;code&gt;[proxy.discovery]: realm ...&lt;/code&gt; 的 WARN&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;DNS 查詢失敗（不是「沒有」），這個 realm 丟棄 30 秒。檢查這台主機的 DNS 設定（&lt;code&gt;/etc/resolv.conf&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;查到了伺服器，但 &lt;code&gt;cannot connect ... TLS:&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;對方的憑證不是 &lt;code&gt;ca_file&lt;/code&gt; 簽的；或開了 &lt;code&gt;realm_names_only&lt;/code&gt;，而對方的憑證上只有主機名稱&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;外校的人第一次登入特別慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;第一次查這個 realm 要等 DNS，NAS 的重送在這段時間會被丟棄。之後依 TTL 記住&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;外校的人連到一半失敗、重來就好&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;load-balance&lt;/code&gt; 的一台上游剛停擺或剛恢復，那台的設備換了台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_proxy_acct_spool_bytes&lt;/code&gt; 一直不降&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某個 realm 的上游還沒恢復，擋住了整個佇列；看 &lt;code&gt;rradius_proxy_server_alive&lt;/code&gt; 是哪一台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;聯盟的對端連進來被關閉，&lt;code&gt;its certificate fits no client&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有 &lt;code&gt;tls_name&lt;/code&gt; 符合它憑證的 &lt;code&gt;[[radius.clients]]&lt;/code&gt; 項目&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>12. 每人一把 Wi-Fi 密碼</title>
            <link>https://embark.systems/rradius/12-psk-wifi/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/12-psk-wifi/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 辦公室有一個 WPA2-PSK 的 SSID（輸入密碼就能連的那種）。印表機、電視、訪客的設備不會 802.1X，所以不能改成&lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/&#34; &gt;第 3 章&lt;/a&gt;的企業 Wi-Fi；但全公司共用一把密碼，有人離職就得全部重設。&lt;/p&gt;&#xA;&lt;p&gt;改成&lt;strong&gt;每個人一把自己的密碼&lt;/strong&gt;，SSID 不變（各廠商叫 DPSK、iPSK、MPSK、PPSK）：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;每個人用自己的密碼連同一個 SSID，rradius 從密碼認出是誰，依人放進不同的 VLAN。&lt;/li&gt;&#xA;&lt;li&gt;離職時只停掉他那一把，其他人不受影響。&lt;/li&gt;&#xA;&lt;li&gt;設備不必先登記 MAC。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;AP 有兩種做法，看你的 AP 支援哪一種：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;做法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;AP 送什麼給 rradius&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;設備要先登記嗎&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;本章的位置&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;從四次交握找出是哪一把&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連線時交握的內容（ANonce 和第 2 個 EAPOL 封包）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;主要的做法，&lt;code&gt;[radius.dpsk]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;依 MAC 回覆密碼&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備的 MAC 位址&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;要&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;#%e7%ac%ac%e4%ba%8c%e7%a8%ae%e5%81%9a%e6%b3%95%e4%be%9d-mac-%e5%9b%9e%e8%a6%86%e5%af%86%e7%a2%bc&#34; &gt;第二種做法&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;四次交握是設備和 AP 互相證明知道密碼的過程，密碼本身不會傳出來。rradius 拿每個人的金鑰去試，算得出同樣結果的那一把就是這個人的。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/psk-wifi/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.dpsk]&lt;/code&gt;、兩種 AP 各一個 client、&lt;code&gt;[accounts]&lt;/code&gt;（停用、啟用人）、&lt;code&gt;[accounts.dpsk]&lt;/code&gt;（金鑰）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;setup.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;產生 &lt;code&gt;dpsk.key&lt;/code&gt; 和封存好的示範資料&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;mac-psk.lua&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;第二種做法的腳本&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;people&lt;/code&gt;（人和 VLAN）、&lt;code&gt;dpsk_keys&lt;/code&gt;（每人的金鑰）、&lt;code&gt;device_psk&lt;/code&gt;（依 MAC 的密碼）、&lt;code&gt;accounting&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-產生金鑰和示範資料&#34;&gt;1. 產生金鑰和示範資料&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cargo build --release&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;examples/scenarios/psk-wifi/setup.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;它做兩件事：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;產生 &lt;code&gt;dpsk.key&lt;/code&gt;：封存金鑰用的主金鑰，64 個十六進位字元，權限 0600。&lt;/li&gt;&#xA;&lt;li&gt;用 &lt;code&gt;rradius-server dpsk-seal&lt;/code&gt; 封存三個示範的人的密碼，寫成 &lt;code&gt;migrations/2_demo_keys.sql&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這兩個檔案不在 repo 裡，因為主金鑰不該公開，而封存的結果跟著主金鑰走。&lt;strong&gt;已經有的檔案不會覆蓋：&lt;/strong&gt; 換掉主金鑰，舊的資料就打不開。&lt;/p&gt;&#xA;&lt;p&gt;用發行檔時 &lt;code&gt;setup.sh&lt;/code&gt; 會自己找到 &lt;code&gt;bin/rradius-server&lt;/code&gt;；放在別的地方時用 &lt;code&gt;RRADIUS_SERVER=/path/to/rradius-server&lt;/code&gt; 指定。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-啟動&#34;&gt;2. 啟動&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/psk-wifi/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;3-測試&#34;&gt;3. 測試&#xA;&lt;/h3&gt;&lt;p&gt;&lt;strong&gt;四次交握沒辦法用 &lt;code&gt;radtest&lt;/code&gt; 模擬，&lt;/strong&gt; 要有支援的 AP 和一台設備才測得到。自動測試的做法是重放一段事先錄好的交握（由另一個獨立的程式用 &lt;code&gt;bob-passphrase&lt;/code&gt; 算出來的），確認：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;請求&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;bob 的交握，SSID &lt;code&gt;office&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept，VLAN 30，&lt;code&gt;Tunnel-Password&lt;/code&gt; 解開是 bob 的 PMK&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一段交握，改掉一個位元&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject：沒有人的密碼對得上&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一段交握，SSID 換成 &lt;code&gt;guest&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject：這個 SSID 沒有金鑰&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;user disable bob&lt;/code&gt; 之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject，立刻生效&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;user enable bob&lt;/code&gt; 之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;dpsk delete --ssid office bob&lt;/code&gt; 之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;仍然 Access-Accept（設備上次對上的那把還記著）；送 SIGHUP 後 Access-Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;dpsk add --ssid office bob&lt;/code&gt;（密碼 &lt;code&gt;bob-passphrase&lt;/code&gt;）之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;認證紀錄會寫出認到的是誰：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;authentication protocol=&amp;#34;radius&amp;#34; client=&amp;#34;office-aps&amp;#34; source=10.35.0.7 user=&amp;#34;020000000099&amp;#34; account=&amp;#34;bob&amp;#34; chain=&amp;#34;default&amp;#34; handler=&amp;#34;dpsk&amp;#34; decision=&amp;#34;accept&amp;#34;&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;code&gt;user&lt;/code&gt; 是 AP 送來的名稱（通常是設備的 MAC），&lt;code&gt;account&lt;/code&gt; 是對上密碼的人。&lt;/p&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;dpsk&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;candidates_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT identity, pmk FROM dpsk_keys WHERE ssid = ? LIMIT 10000&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;dpsk.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cache_lifetime_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;3600000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;max_candidates&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;10000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;candidates_query&lt;/code&gt;&lt;/strong&gt; 回傳這個 SSID 所有人的 (身分, 封存的 PMK)。&lt;code&gt;?&lt;/code&gt; 代入 SSID。rradius 依序逐一試，最多試 &lt;code&gt;max_candidates&lt;/code&gt; 個。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;查詢要自己加 &lt;code&gt;LIMIT&lt;/code&gt;。&lt;/strong&gt; &lt;code&gt;max_candidates&lt;/code&gt; 只限制試幾個，查詢結果還是整批讀進來。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;PMK 是什麼：&lt;/strong&gt; WPA2 實際用的金鑰，由密碼和 SSID 算出來。存 PMK 而不存密碼，每次比對就不必重算（重算一次要幾毫秒，試一萬個人就太慢）。&lt;strong&gt;拿到 PMK 就能連上那個 SSID，&lt;/strong&gt; 所以資料表裡只放封存過的；沒封存的值打不開，會被略過。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;key_file&lt;/code&gt;&lt;/strong&gt; 是封存用的主金鑰。每個節點都要放同一把，權限只能是 0600、0640 或 0400 這類，否則啟動失敗。&lt;strong&gt;要另外備份：&lt;/strong&gt; 它不在資料庫裡，遺失就要請每個人重設密碼。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;cache_lifetime_ms&lt;/code&gt;：&lt;/strong&gt; 記住每台設備在這個 SSID 上次對上的那一把，下次先試它，不必查資料庫。對不上（設備換了密碼）就忘掉，重新找。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;strong&gt;有多快：&lt;/strong&gt; 在開發用的機器上量，試完一萬個候選約 11 毫秒，五萬個約 55 毫秒；用記住的那一把不到 1 微秒。同時最多 4 個搜尋，再多的請求直接丟棄，由 AP 重送。AP 和設備在交握中願意等多久因廠商而異，沒有實機確認，人數很多時請先實測。量測見 usage 2.15 節。&lt;/p&gt;&#xA;&lt;h3 id=&#34;對上之後這個人能不能連&#34;&gt;對上之後：這個人能不能連&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;sql&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;user_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT NULL FROM people WHERE identity = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;certificate_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT 1 FROM people WHERE identity = ? AND enabled = 1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;reply_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;&amp;#34;&amp;#34;WITH p AS (SELECT vlan FROM people WHERE identity = ?)&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#e6db74&#34;&gt;  SELECT &amp;#39;Tunnel-Type:1&amp;#39;, &amp;#39;VLAN&amp;#39; FROM p&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#e6db74&#34;&gt;  UNION ALL SELECT &amp;#39;Tunnel-Medium-Type:1&amp;#39;, &amp;#39;IEEE-802&amp;#39; FROM p&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#e6db74&#34;&gt;  UNION ALL SELECT &amp;#39;Tunnel-Private-Group-Id:1&amp;#39;, vlan FROM p&amp;#34;&amp;#34;&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;密碼對上只證明「這是 bob」。接著身分會交給這個 client 的認證串接，當成&lt;strong&gt;已經證明的名稱&lt;/strong&gt;，和憑證登入相同：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;certificate_query&lt;/code&gt;&lt;/strong&gt; 查得到就接受。把停用條件寫在這裡（&lt;code&gt;enabled = 1&lt;/code&gt;），停用一個人就立刻生效，不必等記住的金鑰到期。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;reply_query&lt;/code&gt;&lt;/strong&gt; 給這個人的 VLAN。&lt;code&gt;reply_query&lt;/code&gt; 只能有一個 &lt;code&gt;?&lt;/code&gt;，所以用 &lt;code&gt;WITH&lt;/code&gt; 查一次、回三列。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;user_query&lt;/code&gt;&lt;/strong&gt; 是必填的，但這個 SSID 沒有帳號密碼登入。範例讓密碼欄一律是 &lt;code&gt;NULL&lt;/code&gt;：只帶名稱和密碼的請求都會被拒絕。&lt;/li&gt;&#xA;&lt;li&gt;用腳本決定時，腳本看到的 &lt;code&gt;eap_method&lt;/code&gt; 是 &lt;code&gt;&#39;dpsk&#39;&lt;/code&gt;，&lt;code&gt;get_attr(&#39;User-Name&#39;)&lt;/code&gt; 是對上的身分。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;接受時，rradius 自動把 PMK 加進回覆，&lt;/strong&gt; AP 才能完成交握：hostapd 的請求回 &lt;code&gt;Tunnel-Password&lt;/code&gt;，Ruckus 的回 &lt;code&gt;Ruckus-DPSK&lt;/code&gt;。這兩個屬性不用自己設。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;對不上任何人時直接回 Access-Reject，&lt;/strong&gt; 不經過串接和腳本。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;新增停用換密碼&#34;&gt;新增、停用、換密碼&#xA;&lt;/h2&gt;&lt;h3 id=&#34;新增一個人&#34;&gt;新增一個人&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 先把 dave 加進 people 表（決定 VLAN，見下方），再加他在 office 的金鑰。&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;printf &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;%s\n&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;dave-passphrase&amp;#39;&lt;/span&gt; | rradius-server dpsk add --config rradius.toml --ssid office dave&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# added key of dave for office&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;密碼從標準輸入讀，&lt;/strong&gt; 不放在參數裡（參數會留在 shell 歷史）。在終端機上會問兩次、不顯示。密碼要是 8 到 63 個可列印的 ASCII 字元，或 64 個十六進位字元的 PSK。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;寫進資料表的是封存後的 PMK，&lt;/strong&gt; 綁定身分和 SSID，搬到別人名下或別的 SSID 都打不開。同一把密碼要用在兩個 SSID，就各執行一次。密碼本身不會存下來。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;要在有 &lt;code&gt;key_file&lt;/code&gt; 的主機上執行，&lt;/strong&gt; 通常就是節點本身。寫入經過叢集，所有節點立刻看得到，不必重啟。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;執行哪一條 SQL 寫在 &lt;code&gt;[accounts.dpsk]&lt;/code&gt;：&lt;/strong&gt; &lt;code&gt;?1&lt;/code&gt; 是身分、&lt;code&gt;?2&lt;/code&gt; 是 SSID、&lt;code&gt;?3&lt;/code&gt; 是封存好的 PMK。範例：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;accounts&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;dpsk&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;add&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;INSERT INTO dpsk_keys (identity, ssid, pmk) VALUES (?1, ?2, ?3)&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;passwd&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE dpsk_keys SET pmk = ?3 WHERE identity = ?1 AND ssid = ?2&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;delete&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;DELETE FROM dpsk_keys WHERE identity = ?1 AND ssid = ?2&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;show&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT identity, ssid FROM dpsk_keys WHERE identity = ?1 AND ssid = ?2&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;delete&lt;/code&gt; 和 &lt;code&gt;show&lt;/code&gt; 可以不用 &lt;code&gt;?2&lt;/code&gt;，一次處理這個人所有的 SSID；指令仍然要給 &lt;code&gt;--ssid&lt;/code&gt;，但不會代入，結果印成 &lt;code&gt;deleted keys of bob&lt;/code&gt;。完整規則見參考文件 2.14 節。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;人的那一列&lt;/strong&gt; 在 &lt;code&gt;people&lt;/code&gt; 表，決定能不能連和 VLAN。範例的 &lt;code&gt;[accounts]&lt;/code&gt; 只設了 &lt;code&gt;enable&lt;/code&gt;、&lt;code&gt;disable&lt;/code&gt;、&lt;code&gt;show&lt;/code&gt;；要用 &lt;code&gt;user add&lt;/code&gt; 新增人，在 &lt;code&gt;[accounts]&lt;/code&gt; 加一條寫 &lt;code&gt;people&lt;/code&gt; 的 &lt;code&gt;add&lt;/code&gt;（它會要一個密碼值，這個情境用不到，可以寫進一個不用的欄位，或直接用 SQL 加）。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;大量匯入&lt;/strong&gt; 仍可以用 &lt;code&gt;dpsk-seal&lt;/code&gt; 產生封存值，寫成一個 migration 檔（第一次上線時常用，見 &lt;code&gt;setup.sh&lt;/code&gt; 的做法）。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;停用和啟用&#34;&gt;停用和啟用&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server user disable --config rradius.toml bob&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server user enable --config rradius.toml bob&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server user show --config rradius.toml bob&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;範例的 &lt;code&gt;[accounts]&lt;/code&gt; 改的是 &lt;code&gt;people&lt;/code&gt; 表的 &lt;code&gt;enabled&lt;/code&gt;。整個叢集立刻生效，下一次連線就被拒絕。&lt;strong&gt;已經連上的設備不會被踢下線，&lt;/strong&gt; 要等它重新連線（漫遊、休眠後回來）；要立刻斷線，見&lt;a class=&#34;link&#34; href=&#34;../07-broadband/#coa-%e8%bd%89%e9%80%81&#34; &gt;第 7 章的 CoA&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;h3 id=&#34;換密碼刪除&#34;&gt;換密碼、刪除&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;printf &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;%s\n&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;new-passphrase&amp;#39;&lt;/span&gt; | rradius-server dpsk passwd --config rradius.toml --ssid office bob&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server dpsk delete --config rradius.toml --ssid office bob&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server dpsk show --config rradius.toml --ssid office bob&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;結果是 &lt;code&gt;key changed for bob for office&lt;/code&gt;、&lt;code&gt;deleted key of bob for office&lt;/code&gt;；沒有這一列時印 &lt;code&gt;no key of bob for office&lt;/code&gt;，狀態 1。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;之後要對每個節點送 SIGHUP：&lt;/strong&gt; rradius 記著每台設備上次用的那一把，不送的話，那些設備在 &lt;code&gt;cache_lifetime_ms&lt;/code&gt; 內還能用舊密碼連上。指令只改資料表，不會通知節點。只靠 &lt;code&gt;enabled = 0&lt;/code&gt; 停用時不必，因為每次連線都會查 &lt;code&gt;certificate_query&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;h3 id=&#34;換主金鑰&#34;&gt;換主金鑰&#xA;&lt;/h3&gt;&lt;p&gt;每個節點把新的設成 &lt;code&gt;key_file&lt;/code&gt;、舊的設成 &lt;code&gt;previous_key_file&lt;/code&gt;，送 SIGHUP；這段期間兩把都打得開。把每個人的密碼用新金鑰重新封存、換掉資料表裡的值之後，再拿掉 &lt;code&gt;previous_key_file&lt;/code&gt;。&lt;code&gt;dpsk passwd&lt;/code&gt; 和 &lt;code&gt;dpsk-seal&lt;/code&gt; 都只接受密碼（或 64 個十六進位字元的 PSK），不能直接把舊的封存值換成新的，所以要有原本的密碼。&lt;/p&gt;&#xA;&lt;h2 id=&#34;第二種做法依-mac-回覆密碼&#34;&gt;第二種做法：依 MAC 回覆密碼&#xA;&lt;/h2&gt;&lt;p&gt;AP 不會送四次交握時（Cisco iPSK、Aruba MPSK、Meraki、Mist，或 hostapd 的 &lt;code&gt;wpa_psk_radius=1&lt;/code&gt;、&lt;code&gt;2&lt;/code&gt;），它在設備連線時用 MAC 位址問 rradius「這台的密碼是什麼」。每台設備要先登記。這種做法不需要 &lt;code&gt;[radius.dpsk]&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;mac-psk&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;policy&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;first_match&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;chains&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;mac-psk&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;script&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;mac-psk.lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;lab-aps&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.36.0.0/24&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;lab-aps.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;mac-psk&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;mac-psk.lua&lt;/code&gt; 做的事：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&lt;code&gt;User-Name&lt;/code&gt; 和 &lt;code&gt;Calling-Station-Id&lt;/code&gt; 要是同一個 MAC（各種寫法都先統一成 12 個小寫十六進位字元）。&lt;/li&gt;&#xA;&lt;li&gt;查 &lt;code&gt;device_psk&lt;/code&gt; 表，查不到就拒絕。&lt;/li&gt;&#xA;&lt;li&gt;用 &lt;code&gt;set_attr(&#39;Tunnel-Password&#39;, ...)&lt;/code&gt; 回覆密碼，rradius 會用共用密碼加密；再回 VLAN。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;本機測試（把 &lt;code&gt;lab-aps&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;）：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;User-Name=00-11-22-33-44-AA,User-Password=00-11-22-33-44-AA,Calling-Station-Id=00:11:22:33:44:aa&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  | radclient -x 127.0.0.1:1812 auth lab-aps-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;會收到 Access-Accept，帶 &lt;code&gt;Tunnel-Password&lt;/code&gt; 和 VLAN 40。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;各廠商要的屬性不同：&lt;/strong&gt; 範例用的 &lt;code&gt;Tunnel-Password&lt;/code&gt; 適用 hostapd、Meraki、Mist。Cisco 用 &lt;code&gt;Cisco-AVPair&lt;/code&gt;，Aruba 用 &lt;code&gt;Aruba-MPSK-Passphrase&lt;/code&gt;，Ruckus 用 &lt;code&gt;Ruckus-DPSK&lt;/code&gt;（要用 &lt;code&gt;wpa_pmk&lt;/code&gt; 函式算出 PMK），寫法見 usage 2.15 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;資料表裡是明文的密碼，&lt;/strong&gt; 因為 AP 要拿到密碼本身。讀得到資料庫的人就看得到。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;Cisco-AVPair&lt;/code&gt; 的值不會加密，&lt;/strong&gt; 只在可信任的網路或 RadSec 上用。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;MAC 不是秘密。&lt;/strong&gt; 別人可以冒用登記過的 MAC 來問，但問到的密碼是加密後給 AP 的，設備還是要自己知道密碼才連得上。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;只支援 WPA2-PSK（HMAC-SHA1 的那一種）。&lt;/strong&gt; WPA3-SAE、WPA2-PSK-SHA256 和強制 PMF（管理訊框保護）時用的版本都不支援，收到時回 Access-Reject，記錄寫 &lt;code&gt;key descriptor version 3 is not supported&lt;/code&gt;。SSID 要設成純 WPA2-PSK，PMF 不能設成「必要」。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;支援的 AP：&lt;/strong&gt; hostapd 2.11 以後的 &lt;code&gt;wpa_psk_radius=3&lt;/code&gt;，和會送 &lt;code&gt;Ruckus-DPSK-Params&lt;/code&gt; 的 Ruckus AP。AP 的 MAC 和 SSID 從 &lt;code&gt;Called-Station-Id&lt;/code&gt; 讀（格式 &lt;code&gt;AA-BB-CC-DD-EE-FF:SSID&lt;/code&gt;），設備的 MAC 從 &lt;code&gt;Calling-Station-Id&lt;/code&gt; 讀。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;密碼要夠長、每個人不同。&lt;/strong&gt; 兩個人設了同一把密碼時，認到的是查詢結果裡排前面的那個人。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不要讓使用者自己選太短的密碼：&lt;/strong&gt; 聽得到無線訊號的人可以錄下交握離線猜密碼，這是 WPA2-PSK 本身的限制。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有測過的：&lt;/strong&gt; 任何實體 AP。四次交握的比對和 FreeRADIUS 3.2.10 的 &lt;code&gt;dpsk&lt;/code&gt; 模組交叉確認過（同一段交握，兩邊找出同一把密碼）；Ruckus 的回覆格式來自它的字典說明和社群討論，沒有官方文件；第二種做法各廠商的屬性沒有用實體設備驗證過。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，提到 &lt;code&gt;dpsk.key&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;還沒執行 &lt;code&gt;setup.sh&lt;/code&gt;，或檔案的權限太寬（要 0600 這類）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每個人都連不上，記錄有 &lt;code&gt;do not open with key_file&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料表裡的值不是用這把 &lt;code&gt;dpsk.key&lt;/code&gt; 封存的，或封存時的身分、SSID 和資料列不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;key descriptor version 3 is not supported&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SSID 開了 PMF 必要或 SHA256，改成純 WPA2-PSK&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;Called-Station-Id ... is not &amp;lt;access point MAC&amp;gt;:&amp;lt;SSID&amp;gt;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;AP 送的 &lt;code&gt;Called-Station-Id&lt;/code&gt; 沒有帶 SSID，調整 AP 的設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;密碼對了還是被拒絕，紀錄的 &lt;code&gt;account&lt;/code&gt; 有名字&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;密碼對上了，但 &lt;code&gt;certificate_query&lt;/code&gt; 查不到：這個人被停用，或 &lt;code&gt;people&lt;/code&gt; 表沒有他&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;請求被當成一般登入，&lt;code&gt;handler&lt;/code&gt; 不是 &lt;code&gt;dpsk&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;AP 沒有送交握的屬性：AP 不支援這種做法，或沒有開（hostapd 是 &lt;code&gt;wpa_psk_radius=3&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;刪掉金鑰後還能連&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有送 SIGHUP，設備上次用的那一把還記著&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_dpsk_total{result=&amp;quot;busy&amp;quot;}&lt;/code&gt; 增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同時超過 4 個搜尋：人數太多或同時連線太多，縮小每個 SSID 的候選&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>13. 用 SIM 卡登入 Wi-Fi（EAP-AKA&#39;）</title>
            <link>https://embark.systems/rradius/13-sim-wifi/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/13-sim-wifi/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 工廠的手持終端機、堆高機上的車機都裝了公司自己發的 USIM 卡。希望這些設備連 Wi-Fi 時直接用卡片驗證：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;不必替每台設備發憑證、管到期日。&lt;/li&gt;&#xA;&lt;li&gt;沒有密碼可以外流或被猜中；卡片裡的金鑰讀不出來。&lt;/li&gt;&#xA;&lt;li&gt;卡片和伺服器&lt;strong&gt;互相&lt;/strong&gt;驗證，設備不會連上假的基地台。&lt;/li&gt;&#xA;&lt;li&gt;遺失的設備，停掉那張卡就好。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這是 &lt;strong&gt;EAP-AKA&amp;rsquo;&lt;/strong&gt;：行動網路用的驗證方式，搬到 Wi-Fi 的 802.1X 上。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;先確認適不適用：&lt;/strong&gt; rradius 只驗證&lt;strong&gt;你自己發的卡&lt;/strong&gt;，也就是你手上有每張卡的 Ki 和 OPc（Milenage 演算法）。它不接電信商的系統（HSS），所以電信商發的 SIM 卡不能用。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/sim-wifi/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.eap]&lt;/code&gt; 只開 &lt;code&gt;aka-prime&lt;/code&gt;、&lt;code&gt;[radius.eap.aka]&lt;/code&gt;、&lt;code&gt;aka&lt;/code&gt; 指令用的 &lt;code&gt;[accounts.aka]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;setup.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;產生主金鑰 &lt;code&gt;aka.key&lt;/code&gt; 和一張加密好的示範卡&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;aka_subscribers&lt;/code&gt;（卡）、&lt;code&gt;accounting&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;幾個名詞&#34;&gt;幾個名詞&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;名詞&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;意思&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;IMSI&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;卡片的編號，最多 15 位數字。在這裡就是帳號&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Ki&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;卡片的金鑰，32 個十六進位字元。卡片和伺服器各有一份，&lt;strong&gt;外洩就能複製這張卡&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;OPc&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;由營運者金鑰和 Ki 算出來的值，也是每張卡一個，同樣要保密&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SQN&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;序號。每驗證一次就往前，卡片不接受用過的序號，所以錄下來的驗證不能重放&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;向量&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;伺服器為一次驗證算出來的一組值（亂數、給卡片驗證的值、預期的回答）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-產生主金鑰和示範卡&#34;&gt;1. 產生主金鑰和示範卡&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cargo build --release&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;examples/scenarios/sim-wifi/setup.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;產生 &lt;code&gt;aka.key&lt;/code&gt;：加密 Ki、OPc 用的主金鑰，64 個十六進位字元，權限 0600。&lt;/li&gt;&#xA;&lt;li&gt;用 &lt;code&gt;rradius-server aka-seal&lt;/code&gt; 加密一張示範卡的 Ki 和 OPc，寫成 &lt;code&gt;migrations/2_demo_subscribers.sql&lt;/code&gt;。示範卡用的是 3GPP 公開的測試值，IMSI 是 &lt;code&gt;001010000000001&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這兩個檔案不在 repo 裡。&lt;strong&gt;已經有的檔案不會覆蓋：&lt;/strong&gt; 換掉主金鑰，資料表裡的密文就解不開。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-啟動&#34;&gt;2. 啟動&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/sim-wifi/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;3-測試&#34;&gt;3. 測試&#xA;&lt;/h3&gt;&lt;p&gt;EAP-AKA&amp;rsquo; 要有卡片（或模擬卡片的程式）才測得到，&lt;code&gt;radtest&lt;/code&gt; 做不到。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;自動測試&lt;/strong&gt; 自己扮演卡片，用示範卡的 Ki、OPc 走完整段驗證，確認下表的每一列。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;用 &lt;code&gt;eapol_test&lt;/code&gt;：&lt;/strong&gt; 專案的互通測試用自己編譯、開了模擬 USIM 的 wpa_supplicant 2.11 &lt;code&gt;eapol_test&lt;/code&gt;，做法在 &lt;code&gt;docker/interop/aka-client/&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;情況&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;示範卡登入&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept，&lt;code&gt;User-Name&lt;/code&gt; 是 IMSI，&lt;code&gt;Filter-Id = &amp;quot;plant-devices&amp;quot;&lt;/code&gt;，帶無線加密用的金鑰&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一張卡，卡片的序號比伺服器新&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;卡片要求重新同步，伺服器跟上後 Access-Accept&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一個 IMSI，Ki 不同（複製失敗的卡）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒發過的 IMSI&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;aka disable 001010000000001&lt;/code&gt; 之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;aka add 001010000000002&lt;/code&gt;（給 Ki、OPc）之後，用那張卡登入&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;認證紀錄：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;authentication protocol=&amp;#34;radius&amp;#34; client=&amp;#34;plant-wlc&amp;#34; source=10.45.0.10 user=&amp;#34;anonymous@wlan.example&amp;#34; account=&amp;#34;001010000000001&amp;#34; chain=&amp;#34;eap&amp;#34; handler=&amp;#34;eap-aka-prime&amp;#34; decision=&amp;#34;accept&amp;#34;&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;eap&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;methods&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;aka-prime&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;eap&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;aka&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;network_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;WLAN&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;aka.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;subscriber_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT ki, opc FROM aka_subscribers WHERE imsi = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;current_sqn_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT sqn FROM aka_subscribers WHERE imsi = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;proven_sqn_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE aka_subscribers SET sqn = max(sqn, ?) WHERE imsi = ? RETURNING sqn&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;resync_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE aka_subscribers SET sqn = max(sqn, ?) + 32 WHERE imsi = ? RETURNING sqn&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;只有 &lt;code&gt;aka-prime&lt;/code&gt; 時不需要伺服器憑證，&lt;/strong&gt; 也不能設 &lt;code&gt;cert_file&lt;/code&gt;、&lt;code&gt;key_file&lt;/code&gt;。同時要開 EAP-TLS 或 PEAP 時再加憑證，並在每個 client 設 &lt;code&gt;eap_methods&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/#%e8%a8%ad%e5%ae%9a%e8%aa%aa%e6%98%8e&#34; &gt;第 3 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;network_name&lt;/code&gt;&lt;/strong&gt; 會參與金鑰的計算，設備端可能會比對，兩邊要一樣。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;subscriber_query&lt;/code&gt;&lt;/strong&gt; 回傳加密後的 Ki 和 OPc。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;current_sqn_query&lt;/code&gt;、&lt;code&gt;proven_sqn_query&lt;/code&gt;：序號在卡片答對之後才寫。&lt;/strong&gt; 發 Challenge 時只讀目前的序號、用它加 32，不寫回；卡片答對了才用 &lt;code&gt;proven_sqn_query&lt;/code&gt; 寫入。所以只知道 IMSI、沒有卡片的人，再怎麼來要也推不動序號，也鎖不住這張卡（見下方〈防止被濫用〉）。&lt;strong&gt;&lt;code&gt;proven_sqn_query&lt;/code&gt; 一定要寫成 &lt;code&gt;max(sqn, ?)&lt;/code&gt;，&lt;/strong&gt; 序號才只會往前。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;resync_query&lt;/code&gt;&lt;/strong&gt; 在卡片說「我的序號比較新」時用，一樣要寫成 &lt;code&gt;max(sqn, ?)&lt;/code&gt;；寫成 &lt;code&gt;SET sqn = ? + 32&lt;/code&gt; 也能通過檢查，但會讓序號倒退。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;proven_sqn_query&lt;/code&gt; 和 &lt;code&gt;resync_query&lt;/code&gt; 要以 &lt;code&gt;RETURNING&lt;/code&gt; 結尾，最後一個欄位叫 &lt;code&gt;sqn&lt;/code&gt;，否則啟動失敗。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;舊的做法&lt;/strong&gt; 是 &lt;code&gt;next_sqn_query&lt;/code&gt;：每個 Challenge 都先把序號加 32 寫進資料庫，所以要靠每張卡的上限防濫用，而這個上限可以被用光。新部署請用上面的做法；兩種不能同時設。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;卡片通過之後這張卡能不能用&#34;&gt;卡片通過之後：這張卡能不能用&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;sql&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;user_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT NULL FROM aka_subscribers WHERE imsi = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;certificate_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT 1 FROM aka_subscribers WHERE imsi = ? AND enabled = 1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;reply_query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT &amp;#39;Filter-Id&amp;#39;, plan FROM aka_subscribers WHERE imsi = ? AND plan &amp;lt;&amp;gt; &amp;#39;&amp;#39;&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;卡片驗證通過只證明「這是那張卡」。接著 IMSI 交給認證串接，當成&lt;strong&gt;已經證明的名稱&lt;/strong&gt;，規則和憑證登入相同：&lt;code&gt;sql&lt;/code&gt; 處理器看 &lt;code&gt;certificate_query&lt;/code&gt;，查得到就接受。停用條件（&lt;code&gt;enabled = 1&lt;/code&gt;）寫在這裡。&lt;code&gt;user_query&lt;/code&gt; 必填但用不到，範例讓密碼欄一律是 &lt;code&gt;NULL&lt;/code&gt;，所以沒有人能用 IMSI 加密碼登入。&lt;/p&gt;&#xA;&lt;p&gt;用腳本決定時，腳本看到的 &lt;code&gt;eap_method&lt;/code&gt; 是 &lt;code&gt;&amp;quot;aka-prime&amp;quot;&lt;/code&gt;，&lt;code&gt;get_attr(&#39;User-Name&#39;)&lt;/code&gt; 是 IMSI。&lt;/p&gt;&#xA;&lt;h2 id=&#34;發卡停卡&#34;&gt;發卡、停卡&#xA;&lt;/h2&gt;&lt;h3 id=&#34;加一張卡&#34;&gt;加一張卡&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;printf &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;%s\n%s\n&amp;#39;&lt;/span&gt; &amp;lt;Ki&amp;gt; &amp;lt;OPc&amp;gt; | rradius-server aka add --config rradius.toml &lt;span style=&#34;color:#ae81ff&#34;&gt;001010000000002&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# added subscriber 001010000000002&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;Ki 和 OPc 從標準輸入讀，&lt;/strong&gt; 各一行、各 32 個十六進位字元，不放在參數裡。在終端機上會分別問 &lt;code&gt;Ki: &lt;/code&gt;、&lt;code&gt;OPc: &lt;/code&gt;，不顯示輸入。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;指令用 &lt;code&gt;[radius.eap.aka]&lt;/code&gt; 的 &lt;code&gt;key_file&lt;/code&gt; 加密後才寫進資料表，&lt;/strong&gt; 資料表、記錄和指令的輸出都看不到明文。所以要在有主金鑰的主機上執行，通常就是節點本身。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;密文綁定 IMSI 和欄位，&lt;/strong&gt; 搬到別的 IMSI、或把 Ki 和 OPc 兩欄對調都解不開。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;寫入經過叢集，&lt;/strong&gt; 所有節點立刻看得到，不必重啟。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;執行哪一條 SQL 寫在 &lt;code&gt;[accounts.aka]&lt;/code&gt;：&lt;/strong&gt; &lt;code&gt;?1&lt;/code&gt; 是 IMSI，&lt;code&gt;add&lt;/code&gt; 的 &lt;code&gt;?2&lt;/code&gt;、&lt;code&gt;?3&lt;/code&gt; 是加密好的 Ki、OPc。範例：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;accounts&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;aka&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;add&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;INSERT INTO aka_subscribers (imsi, ki, opc) VALUES (?1, ?2, ?3)&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;enable&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE aka_subscribers SET enabled = 1 WHERE imsi = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;disable&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE aka_subscribers SET enabled = 0 WHERE imsi = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;delete&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;DELETE FROM aka_subscribers WHERE imsi = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;show&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT imsi, label, plan, enabled, sqn FROM aka_subscribers WHERE imsi = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;show&lt;/code&gt; 不要選 &lt;code&gt;ki&lt;/code&gt;、&lt;code&gt;opc&lt;/code&gt;。完整規則見參考文件 2.14 節。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;其他欄位&lt;/strong&gt;（&lt;code&gt;label&lt;/code&gt;、&lt;code&gt;plan&lt;/code&gt;）指令不會填，範例的資料表有預設值；要一起寫，就讓 &lt;code&gt;add&lt;/code&gt; 的 SQL 寫固定值，或之後用 SQL 改。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;&lt;code&gt;sqn&lt;/code&gt; 的初始值&lt;/strong&gt; 是資料表的預設（範例是 0），也就是卡片出廠時的序號。比卡片舊沒關係：第一次登入時卡片會要求重新同步，伺服器會跟上。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;大量發卡&lt;/strong&gt; 時可以用 &lt;code&gt;aka-seal&lt;/code&gt; 對每張卡產生密文，寫成一個 migration 檔一次匯入（&lt;code&gt;setup.sh&lt;/code&gt; 就是這樣做的）。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;停卡復卡查看刪除&#34;&gt;停卡、復卡、查看、刪除&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server aka disable --config rradius.toml &lt;span style=&#34;color:#ae81ff&#34;&gt;001010000000001&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server aka enable --config rradius.toml &lt;span style=&#34;color:#ae81ff&#34;&gt;001010000000001&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server aka show --config rradius.toml &lt;span style=&#34;color:#ae81ff&#34;&gt;001010000000001&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server aka delete --config rradius.toml &lt;span style=&#34;color:#ae81ff&#34;&gt;001010000000001&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;結果是 &lt;code&gt;disabled subscriber 001010000000001&lt;/code&gt; 這類訊息；沒有這張卡時印 &lt;code&gt;no subscriber 001010000000001&lt;/code&gt;，狀態 1。整個叢集立刻生效，下一次登入就看得到，因為每次登入都會查資料表，沒有快取。&lt;/p&gt;&#xA;&lt;h2 id=&#34;主金鑰&#34;&gt;主金鑰&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;aka.key&lt;/code&gt; 保護資料表裡所有卡的 Ki 和 OPc。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;能防的：&lt;/strong&gt; 資料庫檔案、備份、叢集節點之間複寫的內容、腳本的 &lt;code&gt;sql_query&lt;/code&gt;、只有資料庫權限的人。這些地方看到的都是密文。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不能防的：&lt;/strong&gt; 拿到主機的人，他讀得到 &lt;code&gt;aka.key&lt;/code&gt; 和程式的記憶體。主金鑰外洩，就要當成所有卡都外洩；Ki 外洩就能複製卡片，換主金鑰也救不回來，只能換卡。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;每個節點都要放同一把。&lt;/strong&gt; 它不在資料庫裡，不會自動複寫。少了會啟動失敗；內容不同時要到解密才知道，那個節點的登入會全部失敗。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;一定要另外備份。&lt;/strong&gt; 遺失就要重新匯入所有卡。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;權限&lt;/strong&gt; 只能是 0600、0640、0400 這類，別人讀得到就拒絕啟動。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;換主金鑰：&lt;/strong&gt; 每個節點放新舊兩把（&lt;code&gt;key_file&lt;/code&gt; 是新的，&lt;code&gt;previous_key_file&lt;/code&gt; 是舊的）並送 SIGHUP；用 &lt;code&gt;aka-seal --key-file 新 --old-key-file 舊 --imsi &amp;lt;IMSI&amp;gt;&lt;/code&gt; 把每張卡的兩個密文重新加密（從標準輸入給舊的密文），換掉資料表裡的值；全部換完後拿掉 &lt;code&gt;previous_key_file&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;防止被濫用&#34;&gt;防止被濫用&#xA;&lt;/h2&gt;&lt;p&gt;伺服器要在對方證明任何事&lt;strong&gt;之前&lt;/strong&gt;先發 Challenge。知道某個 IMSI 的人可以一直來要。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;max_lookups&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;64&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lookup_wait_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;1000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;序號不會被推動：&lt;/strong&gt; 用 &lt;code&gt;current_sqn_query&lt;/code&gt;、&lt;code&gt;proven_sqn_query&lt;/code&gt; 時，沒有卡片的人拿到的 Challenge 不會寫進資料庫，答錯也不會。所以不需要每張卡的上限，攻擊者沒有額度可以用光，真卡隨時登得進來。自動測試用 20 個答錯的對話確認序號不動，真卡之後照常登入。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;代價：&lt;/strong&gt; 卡片收過 Challenge、伺服器卻沒收到回覆時（訊號斷了、NAS 逾時），下一次登入會先多一輪重新同步，再照常成功。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;max_lookups&lt;/code&gt;、&lt;code&gt;lookup_wait_ms&lt;/code&gt;：&lt;/strong&gt; 每個節點同時最多這麼多個訂戶查詢，限制的是資料庫的負擔。滿了先等 &lt;code&gt;lookup_wait_ms&lt;/code&gt;，等不到才拒絕。停電後所有設備同時重新上線時，會排隊而不是立刻失敗。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;舊的做法（&lt;code&gt;next_sqn_query&lt;/code&gt;）&lt;/strong&gt; 每次都推進序號，所以有 &lt;code&gt;max_vectors_per_minute&lt;/code&gt;（每個節點、每張卡每分鐘的上限）和 &lt;code&gt;shared_budget&lt;/code&gt;（整個叢集共用這個上限，登入吞吐大約減半）。攻擊者可以用光這個上限，讓那張卡暫時登不進去。這兩個設定只能配 &lt;code&gt;next_sqn_query&lt;/code&gt; 用。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;IMSI 存不存在看得出來：&lt;/strong&gt; 發過的 IMSI 會收到挑戰，沒發過的立刻失敗。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;IMSI 以明文送出：&lt;/strong&gt; 聽得到無線訊號的人看得到設備的 IMSI。目前沒有假名和快速重新驗證。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有用實體卡確認的：&lt;/strong&gt; 卡片拒絕「同一個序號、不同 RAND」的第二個 Challenge，是依 3GPP 規格推論。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;多節點&#34;&gt;多節點&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;同一次登入要在同一個節點完成，&lt;/strong&gt; 和其他 EAP 方法相同。NAS 用主備，或讓負載平衡器依來源固定節點（&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;序號經過叢集，&lt;/strong&gt; 所以叢集失去多數節點時發不出向量，AKA&amp;rsquo; 登入會失敗。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;aka.key&lt;/code&gt; 每台一份，&lt;/strong&gt; 見上面。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有在實體 USIM 卡和實體設備上測過，&lt;/strong&gt; 只用 wpa_supplicant 的模擬 USIM 和專案自己寫的測試驗證過。各作業系統對「不是電信商發的卡」的支援和設定方式都還不知道，上線前一定要用實際的卡和設備試。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;序號遞增 32&lt;/strong&gt; 是 3GPP 的做法，實際卡片怎麼檢查序號由卡片決定，實機測試才知道。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只有 EAP-AKA&amp;rsquo; 的完整驗證。&lt;/strong&gt; 沒有 EAP-AKA（沒有撇號的舊版）、EAP-SIM。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，提到 &lt;code&gt;aka.key&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;還沒執行 &lt;code&gt;setup.sh&lt;/code&gt;，或檔案權限太寬&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;this subscriber&#39;s Ki: not a sealed value&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料表裡放了明文，要用 &lt;code&gt;aka-seal&lt;/code&gt; 的輸出&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;sealed under a key this server does not have&lt;/code&gt; 或 &lt;code&gt;it does not open&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這個節點的 &lt;code&gt;aka.key&lt;/code&gt; 和加密時用的不同，或密文被搬到別的 IMSI&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;an AUTS with a wrong MAC-S&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;卡片要求重新同步，但資料表裡的 Ki 或 OPc 和卡片不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;too many vectors for this subscriber&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用 &lt;code&gt;next_sqn_query&lt;/code&gt; 時超過 &lt;code&gt;max_vectors_per_minute&lt;/code&gt;：設備一直重來，或有人拿這個 IMSI 反覆嘗試。改用 &lt;code&gt;current_sqn_query&lt;/code&gt;、&lt;code&gt;proven_sqn_query&lt;/code&gt; 就沒有這個上限&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;the proven sequence number could not be stored&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;卡片答對了，但 &lt;code&gt;proven_sqn_query&lt;/code&gt; 失敗、找不到這一列，或沒有寫成 &lt;code&gt;max(sqn, ?)&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;too many subscriber lookups at once&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;大量設備同時登入或資料庫變慢，設備重試即可；常發生就查資料庫&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;resync_query left the sequence number at or below the card&#39;s&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;resync_query&lt;/code&gt; 沒有寫成 &lt;code&gt;max(sqn, ?) + 32&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;卡片一直要求重新同步，登不進去&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料表的序號被推得比卡片能接受的範圍還遠。把 &lt;code&gt;sqn&lt;/code&gt; 改回卡片接受的值：&lt;code&gt;UPDATE aka_subscribers SET sqn = &amp;lt;值&amp;gt; WHERE imsi = &#39;...&#39;&lt;/code&gt;（用 migration 檔）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;卡片驗證通過但被拒絕，&lt;code&gt;EAP conversation ... refused&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;certificate_query&lt;/code&gt; 查不到：卡被停用，或資料表沒有這個 IMSI 的啟用列&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>14. 幾百台分店的 NAS：動態 client</title>
            <link>https://embark.systems/rradius/14-branch-nas/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/14-branch-nas/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 連鎖門市有幾百家分店，每家有一兩台 AP 或閘道，每個月都有新店開張、舊店換設備。照前面幾章的做法，每台 NAS 都要在設定檔寫一個 &lt;code&gt;[[radius.clients]]&lt;/code&gt;，每次異動都要改每個節點的設定檔再重新載入。&lt;/p&gt;&#xA;&lt;p&gt;改成把 NAS 寫在&lt;strong&gt;資料表&lt;/strong&gt;裡：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;來源不在設定檔裡的請求，rradius 依來源位址查資料表，查到就用查到的名稱和共用密碼處理。&lt;/li&gt;&#xA;&lt;li&gt;新增一台只要執行一次 &lt;code&gt;rradius-server client add&lt;/code&gt;，寫進資料表後整個叢集都看得到，不必改設定檔，也不必重啟。&lt;/li&gt;&#xA;&lt;li&gt;每台 NAS 可以有自己的共用密碼。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;strong&gt;什麼時候不需要：&lt;/strong&gt; NAS 只有十幾台、很少變動，寫在設定檔就好。NAS 用 RadSec 時也不需要，它本來就能只靠憑證辨認（&lt;a class=&#34;link&#34; href=&#34;../10-radsec/&#34; &gt;第 10 章&lt;/a&gt;）。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/branch-nas/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.dynamic_clients]&lt;/code&gt;、&lt;code&gt;client&lt;/code&gt; 指令用的 &lt;code&gt;[accounts.clients]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;nas&lt;/code&gt;（分店的 NAS）、帳號和計費（同快速開始）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_demo_data.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;一個示範帳號 clerk1、一台示範的 NAS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;一個封包怎麼被認出來&#34;&gt;一個封包怎麼被認出來&#xA;&lt;/h2&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;來源位址&#xA;  ├─ 符合某個 [[radius.clients]] ─────────────────► 用設定檔的（永遠優先）&#xA;  ├─ 不在 networks 的網段裡 ──────────────────────► 丟棄，不回應&#xA;  └─ 在 networks 裡&#xA;       ├─ 記得這個位址（查到過，還沒過期）─────────► 用記住的名稱和密碼&#xA;       ├─ 記得「查不到」（還沒過期）────────────────► 丟棄&#xA;       └─ 都沒有 → 查資料表&#xA;            ├─ 查到 ─► 記住 lifetime_ms，處理這個封包&#xA;            ├─ 查不到 ─► 記住 negative_lifetime_ms，丟棄&#xA;            └─ 資料庫出錯或太慢 ─► 丟棄，不記住，下一個封包再查&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-啟動&#34;&gt;1. 啟動&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/branch-nas/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;2-加一台-nas&#34;&gt;2. 加一台 NAS&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;printf &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;%s\n&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;store-0107-secret-change-me&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  | ./target/release/rradius-server client add --config examples/scenarios/branch-nas/rradius.toml &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;      --name store-0107-ap1 10.20.1.7&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# added client 10.20.1.7&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;這一列已經寫進整個叢集。之後 &lt;code&gt;10.20.1.7&lt;/code&gt; 用這把共用密碼送來的請求就會被處理，名稱是 &lt;code&gt;store-0107-ap1&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;p&gt;範例的 &lt;code&gt;networks&lt;/code&gt; 是 &lt;code&gt;10.20.0.0/16&lt;/code&gt;，本機測試時請求只能從 &lt;code&gt;127.0.0.1&lt;/code&gt; 送出，所以&lt;strong&gt;在本機要看到動態查詢&lt;/strong&gt;，先把 &lt;code&gt;networks&lt;/code&gt; 改成 &lt;code&gt;[&amp;quot;127.0.0.0/8&amp;quot;]&lt;/code&gt;，再 &lt;code&gt;client add --name test-ap 127.0.0.1&lt;/code&gt;，用那把共用密碼從本機送請求。自動測試就是這樣做的。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-確認&#34;&gt;3. 確認&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;curl -s http://127.0.0.1:9812/metrics | grep rradius_dynamic_client&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;rradius_dynamic_client_lookups_total{result=&amp;quot;found&amp;quot;}&lt;/code&gt;：查到的次數。一台 NAS 在 &lt;code&gt;lifetime_ms&lt;/code&gt; 內只查一次。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;rradius_dynamic_clients&lt;/code&gt;：目前記住幾台。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;dynamic_clients&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;networks&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.20.0.0/16&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;query&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT name, secret FROM nas WHERE address = ?&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lifetime_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;300000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;negative_lifetime_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;60000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;max_clients&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;10000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;networks&lt;/code&gt;（必填）：&lt;/strong&gt; 只有這些網段裡的來源才會查。&lt;strong&gt;設得越精確越好：&lt;/strong&gt; 網段裡任何位址送來一個封包，都會觸發一次資料庫查詢。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;query&lt;/code&gt;（必填）：&lt;/strong&gt; 一個 &lt;code&gt;?&lt;/code&gt;，代入來源位址的文字（&lt;code&gt;10.20.1.5&lt;/code&gt;）。第一欄是名稱，第二欄是共用密碼。&#xA;&lt;ul&gt;&#xA;&lt;li&gt;名稱是空的就用來源位址當名稱。&lt;/li&gt;&#xA;&lt;li&gt;密碼是空的，或名稱和設定檔裡某個 client 相同時，當作查不到，並記錄一行。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;lifetime_ms&lt;/code&gt;：&lt;/strong&gt; 查到的記住多久（預設 5 分鐘）。這段時間內改了資料表，這個節點還是用舊的。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;negative_lifetime_ms&lt;/code&gt;：&lt;/strong&gt; 查不到的記住多久（預設 1 分鐘），這段時間不再查，避免被陌生來源一直觸發查詢。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;max_clients&lt;/code&gt;：&lt;/strong&gt; 最多記住幾台。滿了先清掉過期的，再清掉「查不到」的。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;查詢的時限&lt;/strong&gt; 是 &lt;code&gt;[lua] query_timeout_ms&lt;/code&gt;。範例設成 2 秒。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;新-nas-的第一個請求&#34;&gt;新 NAS 的第一個請求&#xA;&lt;/h3&gt;&lt;p&gt;一個來源正在查的時候，它的封包直接丟棄；同時查詢超過 16 個時也丟棄。所以&lt;strong&gt;新 NAS 的第一個請求通常要靠一次重送才有回應&lt;/strong&gt;，之後就和設定檔裡的 client 一樣快。這是正常的，&lt;code&gt;rradius_dynamic_client_lookups_total{result=&amp;quot;busy&amp;quot;}&lt;/code&gt; 會計數。&lt;/p&gt;&#xA;&lt;h3 id=&#34;動態-client-和設定檔裡的-client-有什麼不同&#34;&gt;動態 client 和設定檔裡的 client 有什麼不同&#xA;&lt;/h3&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;設定檔裡的&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;動態的&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;認證串接&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以用 &lt;code&gt;auth&lt;/code&gt; 指定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;一律用預設串接&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP 方法&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以用 &lt;code&gt;eap_methods&lt;/code&gt; 指定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;伺服器的全部方法&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Message-Authenticator 的設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每個 client 可以覆寫&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用 &lt;code&gt;[radius]&lt;/code&gt; 的設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;當 CoA 的目標（&lt;code&gt;send_coa&lt;/code&gt;、CoA 轉送）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不行&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不行，只有 UDP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每個 client 的指標&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;有&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有，只有上面兩個總數&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;要對某幾台 NAS 送 CoA，或讓它們用別的串接，那幾台就寫在設定檔裡。設定檔裡的永遠優先。&lt;/p&gt;&#xA;&lt;h2 id=&#34;加一台改一台移除一台&#34;&gt;加一台、改一台、移除一台&#xA;&lt;/h2&gt;&lt;h3 id=&#34;用-client-指令&#34;&gt;用 &lt;code&gt;client&lt;/code&gt; 指令&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 加一台：共用密碼從標準輸入讀，不放在命令列&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;printf &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;%s\n&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;&amp;lt;這台的共用密碼&amp;gt;&amp;#39;&lt;/span&gt; | rradius-server client add --config rradius.toml --name store-0405-ap1 10.20.4.5&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 換共用密碼&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;printf &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;%s\n&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;&amp;lt;新的共用密碼&amp;gt;&amp;#39;&lt;/span&gt; | rradius-server client secret --config rradius.toml 10.20.4.5&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# 查看、移除&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server client show --config rradius.toml 10.20.4.5&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server client delete --config rradius.toml 10.20.4.5&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;每個動作執行哪一條 SQL 寫在 &lt;code&gt;[accounts.clients]&lt;/code&gt;，資料表結構由你決定：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;accounts&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;add&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;INSERT INTO nas (address, name, secret) VALUES (?1, ?2, ?3)&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE nas SET secret = ?2 WHERE address = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;delete&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;DELETE FROM nas WHERE address = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;show&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT address, name FROM nas WHERE address = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;?1&lt;/code&gt; 是位址；&lt;code&gt;add&lt;/code&gt; 的 &lt;code&gt;?2&lt;/code&gt; 是名稱、&lt;code&gt;?3&lt;/code&gt; 是共用密碼；&lt;code&gt;secret&lt;/code&gt; 的 &lt;code&gt;?2&lt;/code&gt; 是新的共用密碼。&lt;/strong&gt; 完整規則見參考文件 2.14 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;送出之前先檢查，&lt;/strong&gt; 錯了什麼都不寫、以狀態 2 結束：位址要是一個 IP（不是網段），要落在 &lt;code&gt;networks&lt;/code&gt; 裡，不能落在設定檔任何 client 的位址或網段裡（那樣永遠不會查表）；名稱不能和設定檔的 client 相同（伺服器會當成查不到）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;共用密碼短於 16 個字元時會警告，&lt;/strong&gt; 但照樣寫入，和設定檔裡的 client 相同。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;寫入經過叢集，&lt;/strong&gt; 在任何一個節點上執行都可以。指令用 &lt;code&gt;[cluster]&lt;/code&gt; 的 &lt;code&gt;secret_api&lt;/code&gt; 連線，所以設定檔只讓管理者讀得到。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;結果：&lt;/strong&gt; &lt;code&gt;added client 10.20.4.5&lt;/code&gt;、&lt;code&gt;secret changed for client 10.20.4.5&lt;/code&gt;、&lt;code&gt;deleted client 10.20.4.5&lt;/code&gt;，狀態 0；沒有這一列時印 &lt;code&gt;no client 10.20.4.5&lt;/code&gt;，狀態 1；已經有這個位址或名稱時資料庫拒絕，狀態 1。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;用-migration-檔&#34;&gt;用 migration 檔&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-sql&#34; data-lang=&#34;sql&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;-- 3_new_stores.sql&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;INSERT&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;INTO&lt;/span&gt; nas (address, name, secret) &lt;span style=&#34;color:#66d9ef&#34;&gt;VALUES&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  (&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;10.20.4.5&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;store-0405-ap1&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;&amp;lt;這台的共用密碼&amp;gt;&amp;#39;&lt;/span&gt;),&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  (&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;10.20.4.6&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;store-0405-ap2&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;&amp;lt;這台的共用密碼&amp;gt;&amp;#39;&lt;/span&gt;);&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;放到每個節點，逐台重啟（&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/#%e5%8a%a0%e6%96%b0%e7%9a%84-migration&#34; &gt;第 8 章&lt;/a&gt;）。適合第一次匯入一大批、想把清單留在版本控制裡的情況；之後的異動用 &lt;code&gt;client&lt;/code&gt; 指令。&lt;/p&gt;&#xA;&lt;h3 id=&#34;改了之後多久生效&#34;&gt;改了之後多久生效&#xA;&lt;/h3&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;動作&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;這個節點什麼時候看到&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;加一台新的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;它的下一個封包（之前沒查過）；之前查過而「查不到」的，最多等 &lt;code&gt;negative_lifetime_ms&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;換共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;最多等 &lt;code&gt;lifetime_ms&lt;/code&gt;。期間 NAS 用新密碼送的封包驗證不過，沒有回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;移除一台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;最多等 &lt;code&gt;lifetime_ms&lt;/code&gt;，期間它還是能用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;code&gt;client&lt;/code&gt; 指令只改資料表，不會通知節點，所以上表照樣適用。&lt;strong&gt;要立刻生效，對每個節點送 SIGHUP：&lt;/strong&gt; 重新載入時記住的內容全部清空。換密碼和移除通常要這樣做。&lt;/p&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;共用密碼是明文存在資料表裡。&lt;/strong&gt; 讀得到資料庫的人和 &lt;code&gt;[lua]&lt;/code&gt; 的腳本都看得到。控管資料目錄、備份和腳本的權限。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;來源位址可以偽造。&lt;/strong&gt; UDP 的來源位址不可靠，共用密碼和 Message-Authenticator 才是驗證。範例維持 &lt;code&gt;[radius]&lt;/code&gt; 預設的 &lt;code&gt;require_message_authenticator = &amp;quot;yes&amp;quot;&lt;/code&gt;，這個設定也套用在動態 client 上。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;掃描的代價：&lt;/strong&gt; 有人從網段裡的大量位址（或偽造的來源）送封包時，每個位址觸發一次查詢、記一筆「查不到」。同時查詢的上限（16）和 &lt;code&gt;negative_lifetime_ms&lt;/code&gt; 限制了負擔，但 &lt;code&gt;networks&lt;/code&gt; 還是越小越好，並用防火牆只放行真的有 NAS 的網段。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;資料庫出問題時：&lt;/strong&gt; 已經記住的 NAS 照常服務到 &lt;code&gt;lifetime_ms&lt;/code&gt; 到期；到期後查不了，封包丟棄（計入 &lt;code&gt;result=&amp;quot;failed&amp;quot;&lt;/code&gt;），不會被記成「查不到」。查詢讀的是本機副本，依設計不需要叢集的多數節點（這個情況沒有專門測過）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費暫存：&lt;/strong&gt; 動態 client 的計費進了暫存（&lt;a class=&#34;link&#34; href=&#34;../07-broadband/#%e8%a8%88%e8%b2%bb%e6%9a%ab%e5%ad%98&#34; &gt;第 7 章&lt;/a&gt;）之後，重放時會依當時的來源位址重查，名稱相同才處理。所以&lt;strong&gt;不要在暫存還有資料時改 NAS 的名稱&lt;/strong&gt;，否則那些計費會被移到 &lt;code&gt;rejected.log&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費資料表的 client 欄&lt;/strong&gt; 是資料表裡的名稱，所以名稱要唯一、定了就不要改。範例的 &lt;code&gt;nas.name&lt;/code&gt; 有 &lt;code&gt;UNIQUE&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;監控：&lt;/strong&gt; &lt;code&gt;rradius_dynamic_client_lookups_total{result=&amp;quot;not_found&amp;quot;}&lt;/code&gt; 突然增加，代表有沒登記的設備在送請求，或有人在掃描；&lt;code&gt;result=&amp;quot;failed&amp;quot;&lt;/code&gt; 增加代表資料庫有問題。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有測過的：&lt;/strong&gt; 實體 NAS。情境測試在本機確認了 &lt;code&gt;client add&lt;/code&gt; 後登入和計費、&lt;code&gt;client secret&lt;/code&gt; 之後節點沿用記住的密碼直到 SIGHUP、&lt;code&gt;client delete&lt;/code&gt; 加 SIGHUP 後不再回應。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;新 NAS 完全沒有回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源不在 &lt;code&gt;networks&lt;/code&gt; 裡；資料表的 &lt;code&gt;address&lt;/code&gt; 和 rradius 看到的來源不同（NAT、多個介面）；或剛才查不到，還在 &lt;code&gt;negative_lifetime_ms&lt;/code&gt; 內&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;新 NAS 的第一個請求沒回應，重送就好了&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;正常：查詢期間的封包會丟棄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄說名稱和設定檔裡的 client 相同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料表的 &lt;code&gt;name&lt;/code&gt; 不能和任何 &lt;code&gt;[[radius.clients]]&lt;/code&gt; 的 &lt;code&gt;name&lt;/code&gt; 相同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;換了密碼後這台 NAS 不通&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;節點還記著舊密碼，送 SIGHUP 或等 &lt;code&gt;lifetime_ms&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;移除後還能用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同上&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;動態 client 的 EAP 提供了不該有的方法&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;動態 client 不能設 &lt;code&gt;eap_methods&lt;/code&gt;，會用伺服器的全部方法。要限制就把那台寫進設定檔&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;invalid&amp;quot;}&lt;/code&gt; 增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料表裡的共用密碼和 NAS 上的不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>15. 憑證的撤銷和快速重新連線</title>
            <link>https://embark.systems/rradius/15-wifi-certs/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/15-wifi-certs/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; &lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/&#34; &gt;第 3 章&lt;/a&gt;的企業 Wi-Fi 上線一陣子之後，會遇到兩件事：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;筆電遺失了。&lt;/strong&gt; 它的憑證還有兩年才到期。在資料表停用可以擋下登入，但資安政策要求憑證本身也要撤銷，而且同一張憑證可能還用在別的系統。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;設備在基地台之間漫遊時，每換一台就重做一次完整的 TLS 握手。&lt;/strong&gt; 人多的時候伺服器的 CPU 都花在簽章上，使用者也覺得換基地台會頓一下。多節點時，設備連到另一個節點還要從頭來。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這一章在憑證登入（EAP-TLS）上加三樣東西：撤銷清單（CRL）、線上查詢撤銷狀態（OCSP）、恢復上一次的 session（session resumption）。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/wifi-certs/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.eap]&lt;/code&gt; 的 &lt;code&gt;crl_file&lt;/code&gt;、&lt;code&gt;resumption_ms&lt;/code&gt;、&lt;code&gt;shared_tickets&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;setup.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;產生示範用的 CA、伺服器憑證、兩張筆電憑證（一張已撤銷）、撤銷清單和 &lt;code&gt;ticket.seal&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;devices&lt;/code&gt;（設備和 VLAN）、&lt;code&gt;accounting&lt;/code&gt;，和兩台示範的筆電&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;一次憑證登入要過幾關&#34;&gt;一次憑證登入要過幾關&#xA;&lt;/h2&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;握手：憑證是 client_ca_file 簽的嗎？過期了嗎？在 crl_file 裡嗎？&#xA;  │      （恢復舊 session 時不重做握手，但用當下的 CA 和 CRL 重新檢查一次憑證）&#xA;  ▼&#xA;OCSP（有設定時）：向 CA 的 responder 問這張憑證的狀態&#xA;  ▼&#xA;名稱：EAP Identity 符合憑證上的名稱嗎？&#xA;  ▼&#xA;認證串接：certificate_query 查得到這台設備嗎？&#xA;  ▼&#xA;Access-Accept&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;每一關都能擋下一台設備，快慢不同：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;做法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;多快生效&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;適合&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料表停用（&lt;code&gt;enabled = 0&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;下一次登入，整個叢集&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;日常的停用。只擋 rradius 這裡&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;撤銷清單（CRL）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;新的清單放上每個節點並送 SIGHUP 之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CA 會發 CRL&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;OCSP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;之前問到的答案過期之後（由 CA 決定，常見是幾小時到幾天）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CA 只提供 OCSP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-產生憑證和金鑰&#34;&gt;1. 產生憑證和金鑰&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;examples/scenarios/wifi-certs/setup.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;在情境目錄裡產生 &lt;code&gt;certs/&lt;/code&gt;（CA、伺服器憑證、&lt;code&gt;laptop-001&lt;/code&gt;、已撤銷的 &lt;code&gt;laptop-002&lt;/code&gt;、&lt;code&gt;ca.crl&lt;/code&gt;）和 &lt;code&gt;ticket.seal&lt;/code&gt;。&lt;strong&gt;只供測試。&lt;/strong&gt; 已經有的檔案不會覆蓋。&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-啟動&#34;&gt;2. 啟動&#xA;&lt;/h3&gt;&lt;p&gt;本機測試時把 &lt;code&gt;wlc&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/wifi-certs/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id=&#34;3-測試&#34;&gt;3. 測試&#xA;&lt;/h3&gt;&lt;p&gt;用 &lt;code&gt;eapol_test&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../03-enterprise-wifi/#3-%e7%94%a8-eapol_test-%e6%b8%ac%e8%a9%a6&#34; &gt;第 3 章&lt;/a&gt;有安裝方式），設定檔照第 3 章的 &lt;code&gt;eapol/tls.conf&lt;/code&gt;，把憑證換成這裡的 &lt;code&gt;certs/laptop-001.pem&lt;/code&gt;、&lt;code&gt;certs/laptop-001.key&lt;/code&gt;，&lt;code&gt;identity&lt;/code&gt; 換成 &lt;code&gt;laptop-001.corp.example.com&lt;/code&gt;。本章沒有另外附 &lt;code&gt;eapol_test&lt;/code&gt; 的設定檔，也沒有用它跑過這個情境。&lt;/p&gt;&#xA;&lt;p&gt;自動測試自己扮演筆電，走完整段 EAP-TLS，確認：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;情況&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;laptop-001&lt;/code&gt; 第一次登入&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept，VLAN 10，完整握手&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;laptop-001&lt;/code&gt; 再登入一次&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept，&lt;strong&gt;恢復了上一次的 session&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;laptop-002&lt;/code&gt;（在撤銷清單裡）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;laptop-001&lt;/code&gt; 的憑證，但自稱是 &lt;code&gt;laptop-002&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject：名稱和憑證不符&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;user disable laptop-001.corp.example.com&lt;/code&gt; 之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject，就算是恢復的 session&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;user enable ...&lt;/code&gt; 之後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;撤銷清單crl&#34;&gt;撤銷清單（CRL）&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;eap&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;client_ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;crl_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/ca.crl&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;列在清單裡的憑證握手就失敗。&lt;/strong&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;更新清單後要送 SIGHUP&lt;/strong&gt; 才會重讀；每個節點都要更新檔案並送信號。新的對話用新清單，進行中的對話用舊的做完（最多兩分鐘）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;清單要涵蓋憑證鏈上每一層 CA。&lt;/strong&gt; 有中繼 CA 時，把根 CA 和中繼 CA 的 CRL 串接放進同一個檔案（PEM）。缺一層時所有設備都會被拒絕，記錄寫 &lt;code&gt;UnknownRevocationStatus&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;清單過期時 EAP-TLS 照用，&lt;/strong&gt; 所以要自己確保定期更新；過期後才撤銷的憑證會漏掉。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;排程更新：&lt;/strong&gt; 用 cron 或 systemd timer 定期從 CA 下載 CRL、轉成 PEM、放到 &lt;code&gt;crl_file&lt;/code&gt; 的位置，再送 SIGHUP。下載失敗時保留舊檔，不要放一個空檔上去。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;範例的 &lt;code&gt;setup.sh&lt;/code&gt; 示範了怎麼用 &lt;code&gt;openssl ca&lt;/code&gt; 撤銷一張憑證並產生 CRL，檔案開頭的說明有之後再撤銷一張的指令。&lt;/p&gt;&#xA;&lt;h2 id=&#34;ocspca-不發撤銷清單時&#34;&gt;OCSP：CA 不發撤銷清單時&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;eap&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;ocsp&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;soft&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;ocsp_url&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;http://ocsp.corp.example.com/&amp;#34;&lt;/span&gt;   &lt;span style=&#34;color:#75715e&#34;&gt;# 選填&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;OCSP 是向 CA 的伺服器（responder）即時問「這張憑證還有效嗎」。範例的設定檔裡這兩行是註解，因為示範的 CA 沒有 responder。&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;設定&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;responder 說正常&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;說已撤銷&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;說不知道、沒回應、答案不對&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;&amp;quot;off&amp;quot;&lt;/code&gt;（預設）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不問&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不問&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不問&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;&amp;quot;soft&amp;quot;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;放行&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;放行，記錄 &lt;code&gt;OCSP: no answer, let through&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;&amp;quot;hard&amp;quot;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;放行&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;&amp;quot;soft&amp;quot;&lt;/code&gt; 還是 &lt;code&gt;&amp;quot;hard&amp;quot;&lt;/code&gt;：&lt;/strong&gt; &lt;code&gt;&amp;quot;hard&amp;quot;&lt;/code&gt; 時 responder 一停擺，所有憑證登入都會失敗，等於把 Wi-Fi 的可用性綁在 CA 的 OCSP 服務上。&lt;code&gt;&amp;quot;soft&amp;quot;&lt;/code&gt; 不會，但能擋住 rradius 和 responder 之間連線的人可以讓撤銷不生效。撤銷一定要生效就用 &lt;code&gt;&amp;quot;hard&amp;quot;&lt;/code&gt;，並確保 responder 夠可靠。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;問誰：&lt;/strong&gt; 憑證裡寫的 responder 位址，或 &lt;code&gt;ocsp_url&lt;/code&gt;（會用在憑證鏈的每一張上，所以它要認得整條鏈）。&lt;code&gt;client_ca_file&lt;/code&gt; 裡的 CA 本身不查。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;答案會記住，&lt;/strong&gt; 到它自己寫的到期時間為止。同一台設備再登入不會再問；所以撤銷要等舊答案過期才生效。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;responder 停擺時不會每次登入都等：&lt;/strong&gt; 一次查詢最多等 3 秒，查不到的憑證 90 秒內不再問。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;節點要連得到 responder，&lt;/strong&gt; 通常是 HTTP 的 80 埠。不走環境變數設定的 proxy。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;CRL 和 OCSP 可以同時設，&lt;/strong&gt; 兩個都要通過。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;限制：&lt;/strong&gt; 答案的簽章只支援 RSA（2048 位元以上）和 ECDSA P-256／P-384。&lt;code&gt;client_ca_file&lt;/code&gt; 裡有其他金鑰的 CA 時，設了 &lt;code&gt;ocsp&lt;/code&gt; 就啟動失敗，訊息會指出是第幾個 CA。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;RadSec（&lt;code&gt;[radius.tls]&lt;/code&gt;）和 TACACS+ over TLS（&lt;code&gt;[tacacs.tls]&lt;/code&gt;）也有同樣的 &lt;code&gt;ocsp&lt;/code&gt;、&lt;code&gt;ocsp_url&lt;/code&gt;，用來檢查 NAS 和設備的憑證，做法相同；差別在已開啟的連線大約每分鐘再看一次。完整規則見 usage 2.12 節的〈OCSP〉。&lt;/p&gt;&#xA;&lt;h2 id=&#34;快速重新連線session-resumption&#34;&gt;快速重新連線（session resumption）&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;radius&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;eap&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;resumption_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;3600000&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;shared_tickets&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;ticket_seal_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;ticket.seal&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;設備第一次登入做完整的 TLS 握手。之後在 &lt;code&gt;resumption_ms&lt;/code&gt; 內重新連線（漫遊到另一台基地台、休眠後回來）時，雙方用上一次協商好的秘密直接恢復，省掉憑證交換和簽章。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;安全檢查不會省：&lt;/strong&gt; 恢復時用當下的 &lt;code&gt;client_ca_file&lt;/code&gt; 和 &lt;code&gt;crl_file&lt;/code&gt; 重新檢查上一次的憑證，設了 OCSP 也會查；之後的名稱比對和認證串接和完整握手時相同。所以撤銷和停用對恢復的 session 一樣有效。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;resumption_ms&lt;/code&gt;&lt;/strong&gt; 預設 0（不恢復），最多一天。設多久，取決於你能接受設備多久不重新出示憑證。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;只設-resumption_ms&#34;&gt;只設 &lt;code&gt;resumption_ms&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;session 記在各節點的記憶體裡。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;只有 TLS 1.2 能恢復。&lt;/li&gt;&#xA;&lt;li&gt;設備連到&lt;strong&gt;另一個節點&lt;/strong&gt;時那裡沒有記錄，做完整握手。&lt;/li&gt;&#xA;&lt;li&gt;重新啟動或 SIGHUP 後清空。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;單節點、或 NAS 固定連同一個節點（主備）時這樣就夠了。&lt;/p&gt;&#xA;&lt;h3 id=&#34;加上-shared_tickets--true&#34;&gt;加上 &lt;code&gt;shared_tickets = true&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;rradius 另外發 &lt;strong&gt;session ticket&lt;/strong&gt;：把恢復需要的資料加密後交給設備自己保管，下次連線時設備帶回來。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;設備換到哪個節點都能恢復，&lt;/strong&gt; 因為每個節點都解得開。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;TLS 1.3 也能恢復。&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;加密 ticket 的金鑰由叢集自己輪替：&lt;/strong&gt; 每段 &lt;code&gt;resumption_ms&lt;/code&gt; 一把，存在叢集的資料表裡，各節點共用。不必自己排程換金鑰。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;&lt;code&gt;ticket_seal_file&lt;/code&gt;（必填）：&lt;/strong&gt; 資料表裡的 ticket 金鑰再用這個檔案加密。它不進資料庫，所以只拿到資料庫或備份的人解不開 ticket 金鑰，也就偽造不了 ticket 來冒充設備。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f92672&#34;&gt;(&lt;/span&gt;umask 077; openssl rand -hex &lt;span style=&#34;color:#ae81ff&#34;&gt;32&lt;/span&gt; &amp;gt; ticket.seal&lt;span style=&#34;color:#f92672&#34;&gt;)&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;每個節點都要放同一把，&lt;/strong&gt; 權限只能是 0600、0640、0400 這類。內容不同的節點解不開別人寫的金鑰，記錄寫 &lt;code&gt;does not open with ticket_seal_file&lt;/code&gt;；那個節點不發 ticket、也不收別的節點發的，設備改做完整握手，&lt;strong&gt;登入照常完成&lt;/strong&gt;，只是慢一點。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;資料庫暫時讀不到時&lt;/strong&gt; 也一樣：那次登入不發 ticket，照常完成，記錄寫 &lt;code&gt;EAP session ticket keys: ...&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;哪些方法會恢復&#34;&gt;哪些方法會恢復&#xA;&lt;/h3&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;方法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;恢復嗎&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-TLS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;會。&lt;code&gt;shared_tickets&lt;/code&gt; 時可以跨節點、TLS 1.3 也可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PEAP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只省外層的握手，內層的密碼照樣驗證。不發 ticket，所以只在同一個節點&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-TTLS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不恢復&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-AKA&#39;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不適用，它沒有 TLS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h3 id=&#34;換-ticketseal&#34;&gt;換 &lt;code&gt;ticket.seal&lt;/code&gt;&#xA;&lt;/h3&gt;&lt;p&gt;每個節點把新檔設成 &lt;code&gt;ticket_seal_file&lt;/code&gt;、舊檔設成 &lt;code&gt;previous_ticket_seal_file&lt;/code&gt;，送 SIGHUP。之後新的金鑰用新檔加密，舊檔加密的照樣解得開，已經發出的 ticket 不會失效。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;各節點要在同一段 &lt;code&gt;resumption_ms&lt;/code&gt; 內換完。&lt;/strong&gt; 還沒換的節點解不開已換節點寫的金鑰，那段時間它不發 ticket。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;全部換好、再過三段 &lt;code&gt;resumption_ms&lt;/code&gt; 之後，&lt;/strong&gt; 才拿掉 &lt;code&gt;previous_ticket_seal_file&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;不設 &lt;code&gt;previous_ticket_seal_file&lt;/code&gt; 直接換也可以，代價是最多兩段時間內發出的 ticket 失效，設備做一次完整握手。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;其他省-cpu-的做法&#34;&gt;其他省 CPU 的做法&#xA;&lt;/h2&gt;&lt;p&gt;登入量大時，伺服器憑證改用 &lt;strong&gt;ECDSA P-256&lt;/strong&gt;：在同樣的機器上，每次完整握手用的 CPU 大約是 RSA 2048 的三分之一。曲線用 P-256，不要用 P-384（有舊版 Android 不支援的回報）。伺服器一次只用一張憑證，換之前先用各種設備連一次確認。量測和相容性的說明見 usage 2.12 節。&lt;/p&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;ticket.seal&lt;/code&gt; 和憑證私鑰一樣保護。&lt;/strong&gt; 它遺失不會造成資料遺失（重新產生一把，設備做一次完整握手），但外洩加上資料庫外洩，就能偽造 ticket。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;TLS 1.2 的 ticket 風險比較高：&lt;/strong&gt; ticket 裡有那次連線的主要秘密，拿到當時金鑰的人能算出那次的無線加密金鑰。TLS 1.3 的恢復一定會重新交換金鑰，沒有這個問題。設備都支援 TLS 1.3 時風險小得多。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;監控：&lt;/strong&gt; &lt;code&gt;rradius_eap_sessions_total{method=&amp;quot;tls&amp;quot;,result=&amp;quot;reject&amp;quot;}&lt;/code&gt; 突然增加，可能是 CRL 少了一層、OCSP 設成 &lt;code&gt;&amp;quot;hard&amp;quot;&lt;/code&gt; 而 responder 停擺。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有測過的：&lt;/strong&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;OCSP 不在情境測試裡，&lt;/strong&gt; 因為需要 responder。專案的互通測試（&lt;code&gt;docker/interop/run.sh&lt;/code&gt;）用 OpenSSL 的 responder 測過 EAP-TLS。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;跨節點恢復不在情境測試裡：&lt;/strong&gt; 情境測試只有一個節點，確認了同一個節點上第二次登入恢復了 session、撤銷清單擋下已撤銷的憑證、停用的設備恢復時也被拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;實體基地台和各作業系統。&lt;/strong&gt; 設備會不會帶 ticket 回來、恢復的行為，各家用戶端不同。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;setup.sh&lt;/code&gt; 產生憑證和撤銷清單的部分，在 LibreSSL 3.3（macOS）和 OpenSSL 3.5（Linux 容器）上都跑過。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設了 &lt;code&gt;crl_file&lt;/code&gt; 之後所有設備都被拒絕，記錄有 &lt;code&gt;UnknownRevocationStatus&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;缺少某一層 CA 的 CRL，或放了別的 CA 的 CRL&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;撤銷了還是能登入&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CRL：新清單還沒放到那個節點，或沒送 SIGHUP。OCSP：舊的答案還沒過期，或設成 &lt;code&gt;&amp;quot;soft&amp;quot;&lt;/code&gt; 而 responder 沒回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;OCSP: no good answer: ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;&amp;quot;hard&amp;quot;&lt;/code&gt; 時問不到答案。看後面的原因：responder 連不到、答案過期、簽章不對&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄一直有 &lt;code&gt;OCSP: no answer, let through&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;&amp;quot;soft&amp;quot;&lt;/code&gt; 時 responder 沒回應；節點連得到 responder 嗎&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，提到 &lt;code&gt;ticket_seal_file&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設了 &lt;code&gt;shared_tickets&lt;/code&gt; 但沒有這個檔案、權限太寬，或沒設 &lt;code&gt;resumption_ms&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，提到 &lt;code&gt;ticket_key_file&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;舊版的設定，已經移除。改用 &lt;code&gt;shared_tickets&lt;/code&gt; 和重新產生的 &lt;code&gt;ticket_seal_file&lt;/code&gt;，不要把舊檔改名沿用&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;does not open with ticket_seal_file&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這個節點的 &lt;code&gt;ticket.seal&lt;/code&gt; 和其他節點不同。登入照常，但不會恢復&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;the certificate of a resumed session no longer passes&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;恢復時重新檢查，憑證已撤銷或過期。這是正常的拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設了 &lt;code&gt;resumption_ms&lt;/code&gt; 但每次都是完整握手&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備連到了別的節點而沒有 &lt;code&gt;shared_tickets&lt;/code&gt;；用的是 TTLS；或設備本身不恢復&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>16. 網路設備管理：移轉到 TACACS&#43; over TLS</title>
            <link>https://embark.systems/rradius/16-device-admin-tls/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/16-device-admin-tls/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; &lt;a class=&#34;link&#34; href=&#34;../06-device-admin/&#34; &gt;第 6 章&lt;/a&gt;的 TACACS+ 靠共用密碼混淆封包內容，那只用到 MD5，擋不住能側錄管理網路的人：管理員的密碼和下過的每個指令都可能被解出來。新一代的設備支援 &lt;strong&gt;TACACS+ over TLS&lt;/strong&gt;（RFC 9887）：整條連線放進 TLS 1.3，設備和伺服器用憑證確認彼此。&lt;/p&gt;&#xA;&lt;p&gt;設備不會一天全部換完，所以要有一段兩種並存的時間：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;核心路由器&lt;/strong&gt; 已經支援：改用 TLS 的埠，每台有自己的憑證。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;接入交換器&lt;/strong&gt; 還是舊韌體：繼續用共用密碼的埠。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;全部換完之後，&lt;/strong&gt; 關掉沒有 TLS 的埠。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;這一章沿用第 6 章的帳號、角色和指令記錄，只講 TLS 和移轉。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/device-admin-tls/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[tacacs]&lt;/code&gt; 加 &lt;code&gt;[tacacs.tls]&lt;/code&gt;，兩種 client，一個授權群組&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;make-certs.sh&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;產生示範用的設備 CA、伺服器憑證和三張設備憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;core.secret&lt;/code&gt;、&lt;code&gt;access.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;兩組設備的共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;腳本和資料表用第 6 章的 &lt;code&gt;../device-admin/tacacs.lua&lt;/code&gt; 和 &lt;code&gt;../device-admin/migrations/&lt;/code&gt;，所以兩個目錄要放在一起。&lt;/p&gt;&#xA;&lt;h2 id=&#34;兩個埠&#34;&gt;兩個埠&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;沒有 TLS 的埠&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;TLS 的埠&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[tacacs] port&lt;/code&gt;，預設 49&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[tacacs.tls] port&lt;/code&gt;，預設 300&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;保護&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼的混淆（MD5）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TLS 1.3，設備一定要出示憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;怎麼認得設備&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址，加上憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;要和設備相同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用不到（設定上仍然必填）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;連進來之後，認證、授權、計費的處理完全相同：同樣的串接、腳本和授權群組。&lt;/p&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;h3 id=&#34;1-產生憑證&#34;&gt;1. 產生憑證&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server/examples/scenarios/device-admin-tls&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./make-certs.sh&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;certs/&lt;/code&gt; 裡會有 &lt;code&gt;ca.pem&lt;/code&gt;、伺服器的 &lt;code&gt;server.pem&lt;/code&gt;／&lt;code&gt;server.key&lt;/code&gt;（名稱 &lt;code&gt;tacacs.mgmt.example.net&lt;/code&gt;），和 &lt;code&gt;core-rtr-1&lt;/code&gt;、&lt;code&gt;core-rtr-2&lt;/code&gt;、&lt;code&gt;spare&lt;/code&gt; 三張設備憑證。&lt;strong&gt;只供測試。&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;h3 id=&#34;2-啟動&#34;&gt;2. 啟動&#xA;&lt;/h3&gt;&lt;p&gt;49 和 300 都是 1024 以下的埠，一般帳號綁不了。本機測試先改成 4949 和 4300；正式環境的做法見&lt;a class=&#34;link&#34; href=&#34;../06-device-admin/#%e4%b8%8a%e7%b7%9a%e5%89%8d&#34; &gt;第 6 章的「上線前」&lt;/a&gt;。本機測試時把 &lt;code&gt;core-rtr-1&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd ../../..&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/device-admin-tls/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;記錄會有 &lt;code&gt;TACACS+ Server listening on ...&lt;/code&gt; 和 &lt;code&gt;TACACS+ over TLS listening on ...&lt;/code&gt; 兩行。&lt;/p&gt;&#xA;&lt;h3 id=&#34;3-確認握手&#34;&gt;3. 確認握手&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd examples/scenarios/device-admin-tls&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;openssl s_client -connect 127.0.0.1:4300 -tls1_3 -servername tacacs.mgmt.example.net &lt;span style=&#34;color:#ae81ff&#34;&gt;\&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  -CAfile certs/ca.pem -cert certs/core-rtr-1.pem -key certs/core-rtr-1.key&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;看到 &lt;code&gt;Verify return code: 0 (ok)&lt;/code&gt; 就是憑證這一段通了。&lt;code&gt;openssl&lt;/code&gt; 只能確認握手；登入、授權要由支援 RFC 9887 的設備送出。自動測試用程式扮演設備，確認了下表：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;情況&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;core-rtr-1&lt;/code&gt; 的憑證，從它的位址：netadmin1 登入&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PASS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一條連線：密碼錯誤&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;FAIL&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一條連線：netadmin1 開 shell&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PASS，&lt;code&gt;priv-lvl=15&lt;/code&gt;（腳本依角色決定）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一條連線：noc1 下 &lt;code&gt;configure terminal&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;FAIL&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;封包沒有標明「未混淆」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;ERROR，連線關閉&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;core-rtr-2&lt;/code&gt; 的憑證，從 &lt;code&gt;core-rtr-1&lt;/code&gt; 的位址&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;握手後關閉：憑證對這台的 &lt;code&gt;tls_name&lt;/code&gt; 無效&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不屬於任何設備的憑證（&lt;code&gt;spare&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;握手後關閉&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只會 TLS 1.2 的用戶端&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;握手失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;core-rtr-1&lt;/code&gt; 改連沒有 TLS 的埠&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連線關閉：設了 &lt;code&gt;tls_name&lt;/code&gt; 的設備只能用 TLS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;接入交換器用共用密碼：開 shell&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PASS，&lt;code&gt;priv-lvl=1&lt;/code&gt;（授權群組的規則）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;接入交換器：&lt;code&gt;show running-config&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;FAIL&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;tacacs&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;49&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;enable&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;deny&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;tacacs&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;tls&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;port&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;300&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;cert_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/server.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;key_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/server.key&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;client_ca_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;certs/ca.pem&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_only&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;false&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;client_ca_file&lt;/code&gt; 是簽發設備憑證的 CA。&lt;/strong&gt; 只信任它，不信任系統的根憑證。請用專門給網路設備的 CA：這個 CA 也簽別的用途的憑證時，那些憑證就可能被拿來冒充設備（見下面的 &lt;code&gt;tls_name&lt;/code&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只有 TLS 1.3，設備一定要有憑證。&lt;/strong&gt; 沒有憑證、憑證不對、只會 TLS 1.2 的設備握手就失敗。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;位址用 &lt;code&gt;[tacacs] bind&lt;/code&gt;，&lt;/strong&gt; 兩個埠綁同一個位址。連線數上限和閒置時限也共用。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;用-tls_name-把憑證綁到設備&#34;&gt;用 &lt;code&gt;tls_name&lt;/code&gt; 把憑證綁到設備&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;tacacs&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;core-rtr-1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.50.0.1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;tls_name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;core-rtr-1.mgmt.example.net&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;core.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;tacacs&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;clients&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;name&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;access-switches&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;address&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;10.60.0.0/22&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;secret_file&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;access.secret&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;authorize_group&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;readonly&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;設備一律先用來源位址找到它的 &lt;code&gt;[[tacacs.clients]]&lt;/code&gt; 項目，來源不在名單裡的連線在握手前就關閉。接著看 &lt;code&gt;tls_name&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;client 的設定&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;TLS 的埠&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;沒有 TLS 的埠&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;單一位址，沒有 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以。CA 簽的任何憑證從這個位址都能連&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;單一位址，有 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以，憑證要對這個名稱有效&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;不行&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;網段，沒有 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;不行&lt;/strong&gt;，握手後關閉，記錄 &lt;code&gt;needs tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;網段，有 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以，憑證要對這個名稱有效（可以用萬用字元憑證）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;不行&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;tls_name&lt;/code&gt; 比對憑證 SAN 的 DNS 名稱。&lt;/strong&gt;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;設了 &lt;code&gt;tls_name&lt;/code&gt; 等於宣告「這台已經換好了」：&lt;/strong&gt; 它不能再用沒有 TLS 的埠。就算有人拿到舊的共用密碼、冒用它的位址，也連不進來。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;secret&lt;/code&gt; 仍然必填，&lt;/strong&gt; TLS 的埠用不到它。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;授權沒有變&#34;&gt;授權沒有變&#xA;&lt;/h3&gt;&lt;p&gt;範例的核心路由器沒有設 &lt;code&gt;authorize_group&lt;/code&gt;，授權交給第 6 章的腳本，依使用者的角色決定。接入交換器設了 &lt;code&gt;authorize_group = &amp;quot;readonly&amp;quot;&lt;/code&gt;，由規則決定，不分使用者：netadmin1 在接入交換器上也只有 &lt;code&gt;priv-lvl=1&lt;/code&gt;。兩種做法的差別見&lt;a class=&#34;link&#34; href=&#34;../06-device-admin/#%e4%b8%8d%e5%af%ab%e8%85%b3%e6%9c%ac%e6%8e%88%e6%ac%8a%e7%be%a4%e7%b5%84&#34; &gt;第 6 章&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;移轉的順序&#34;&gt;移轉的順序&#xA;&lt;/h2&gt;&lt;ol&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;準備 CA 和憑證。&lt;/strong&gt; 每台設備一張，名稱用它的管理用主機名稱。伺服器的憑證名稱要是設備設定裡填的那個名稱。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;加上 &lt;code&gt;[tacacs.tls]&lt;/code&gt;，重新啟動。&lt;/strong&gt; 新增這個區段要重啟，不能只送 SIGHUP。這時所有設備照舊用 49 埠，沒有任何影響。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;一台一台換：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;在設備上裝憑證和 CA，設定用 TLS 連 rradius。&lt;/li&gt;&#xA;&lt;li&gt;確認它連得上（看下面的「確認每台設備用的是哪個埠」）。&lt;/li&gt;&#xA;&lt;li&gt;在它的 &lt;code&gt;[[tacacs.clients]]&lt;/code&gt; 加上 &lt;code&gt;tls_name&lt;/code&gt;，送 SIGHUP。從這一刻起它只能用 TLS。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;&lt;strong&gt;第 3 步在第 2 步之後。&lt;/strong&gt; 先加 &lt;code&gt;tls_name&lt;/code&gt; 的話，設備還沒設好 TLS 就會被 49 埠拒絕；設備上保留的本機緊急帳號這時就派上用場。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;原本用一個網段涵蓋的設備&lt;/strong&gt;（範例的 &lt;code&gt;access-switches&lt;/code&gt;）要換時，把已經換好的那幾台獨立成單一位址的項目（最長前綴優先，會蓋過網段），加上 &lt;code&gt;tls_name&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;&lt;strong&gt;全部換完後設 &lt;code&gt;tls_only = true&lt;/code&gt;，送 SIGHUP。&lt;/strong&gt; 沒有 TLS 的埠立刻不再服務：新連線和已開啟的連線收到下一個封包時就關閉，記錄 &lt;code&gt;tls_only takes TACACS+ over TLS only&lt;/code&gt;。下次重新啟動後，這個埠就不開了。&lt;strong&gt;從 &lt;code&gt;true&lt;/code&gt; 改回 &lt;code&gt;false&lt;/code&gt; 要重新啟動。&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;RFC 9887 建議兩種並存的時間越短越好。&lt;/p&gt;&#xA;&lt;h3 id=&#34;確認每台設備用的是哪個埠&#34;&gt;確認每台設備用的是哪個埠&#xA;&lt;/h3&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;認證紀錄&lt;/strong&gt; 每次登入一行，&lt;code&gt;client&lt;/code&gt; 是設備的名稱。把 &lt;code&gt;[log] level&lt;/code&gt; 設成 &lt;code&gt;debug&lt;/code&gt; 可以看到每條 TACACS+ 連線。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;試著收緊：&lt;/strong&gt; 對已經換好的設備加上 &lt;code&gt;tls_name&lt;/code&gt;。它如果其實還在用 49 埠，下一個請求就會失敗，設備會改用本機帳號，你會馬上發現。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;rradius_tacacs_connections_total&lt;/code&gt; 不分埠，兩個埠的連線一起算。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;憑證的撤銷和更新&#34;&gt;憑證的撤銷和更新&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;撤銷清單：&lt;/strong&gt; 設 &lt;code&gt;crl_file&lt;/code&gt;，憑證鏈上每一層 CA 都要有。更新後送 SIGHUP。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;OCSP：&lt;/strong&gt; 設 &lt;code&gt;ocsp = &amp;quot;soft&amp;quot;&lt;/code&gt; 或 &lt;code&gt;&amp;quot;hard&amp;quot;&lt;/code&gt;，做法和 &lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/#ocspca-%e4%b8%8d%e7%99%bc%e6%92%a4%e9%8a%b7%e6%b8%85%e5%96%ae%e6%99%82&#34; &gt;第 15 章&lt;/a&gt;相同。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;已開啟的連線會重新檢查：&lt;/strong&gt; 距離上次檢查超過 60 秒之後，下一個封包進來前再檢查一次憑證（CA、撤銷清單、到期日、&lt;code&gt;tls_name&lt;/code&gt;）。不通過就關閉連線。閒置的連線要等它送下一個封包時才檢查。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;伺服器的憑證到期前換掉，&lt;/strong&gt; 送 SIGHUP：新連線用新的，已開啟的不受影響。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;設備的憑證過期，&lt;/strong&gt; 那台就登不進來，只能用設備的本機帳號。把憑證到期日納入監控。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;設備一定要保留本機的緊急帳號，&lt;/strong&gt; 和第 6 章相同。憑證過期、CA 換了、時鐘不準，都會讓 TLS 連不上。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;設備的時鐘要準。&lt;/strong&gt; 憑證有生效和到期時間，時鐘差太多會握手失敗。設備重開機後還沒對時就要登入時特別容易遇到。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;防火牆：&lt;/strong&gt; 開 300 埠給設備的管理網段。移轉結束後關掉 49。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不做 session resumption。&lt;/strong&gt; 每條連線都做完整握手、檢查憑證；設備維持長連線（single-connection）可以減少握手次數。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;尚未在實體設備上測過，&lt;/strong&gt; 只用程式（rustls 的用戶端）測過。RFC 9887 是 2025 年 12 月發布的，哪些設備、哪個版本支援，要先向廠商確認。設備端的設定指令因廠商而異，這一章沒有附。&lt;/li&gt;&#xA;&lt;li&gt;第 6 章「上線前」的其他事項（49 埠的權限、記錄的保存）照樣適用。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，提到 &lt;code&gt;tacacs.tls&lt;/code&gt; 的憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;還沒執行 &lt;code&gt;make-certs.sh&lt;/code&gt;，或私鑰和憑證不配對&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，提到 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設了 &lt;code&gt;tls_name&lt;/code&gt; 但沒有 &lt;code&gt;[tacacs.tls]&lt;/code&gt;，或那個 client 沒有 &lt;code&gt;address&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備連 300 埠，握手就失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備沒有出示憑證、憑證不是 &lt;code&gt;client_ca_file&lt;/code&gt; 簽的、已撤銷、過期，或設備只會 TLS 1.2&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;握手成功但馬上斷線，記錄有 &lt;code&gt;needs tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這台的 client 是網段又沒有 &lt;code&gt;tls_name&lt;/code&gt;。把它獨立成一個項目並設 &lt;code&gt;tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;握手成功但馬上斷線&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;憑證對這個 client 的 &lt;code&gt;tls_name&lt;/code&gt; 無效：裝錯憑證，或名稱不在 SAN 的 DNS 名稱裡&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;加了 &lt;code&gt;tls_name&lt;/code&gt; 之後那台設備登不進來&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;它還在用 49 埠。先把設備改成 TLS&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每個請求都回 ERROR 然後斷線&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設備在 TLS 上還是送了混淆過的封包（沒有標明未混淆）。設備的 TLS 模式沒有設對&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設了 &lt;code&gt;tls_only = true&lt;/code&gt; 後舊設備全部登不進來&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;還有設備沒換。改回 &lt;code&gt;false&lt;/code&gt; 並重新啟動&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>17. 從舊系統搬帳號</title>
            <link>https://embark.systems/rradius/17-migrate-users/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/17-migrate-users/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 公司要把認證從舊的系統換成 rradius。舊系統可能是一台舊的 RADIUS 伺服器、一個 LDAP 目錄、郵件伺服器的帳號，或某個自己寫的資料庫。裡面有幾千個帳號，密碼都是雜湊過的，沒有人知道明文。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;不想要求每個人重設密碼。&lt;/strong&gt; 把舊系統的雜湊原樣搬過來，使用者用原本的密碼繼續登入。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;舊的雜湊多半很弱&lt;/strong&gt;（MD5、SHA-1）。搬過來之後，改密碼時改存新的格式，舊格式逐漸消失。&lt;/li&gt;&#xA;&lt;li&gt;舊系統的帳號名稱大小寫不一、有的帶網域，要統一。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;如果舊的 LDAP 目錄會繼續留著，不必搬：讓 rradius 直接問目錄（&lt;a class=&#34;link&#34; href=&#34;../05-remote-access/&#34; &gt;第 5 章&lt;/a&gt;）。這一章是要把帳號放進 rradius 自己的資料表。&lt;/p&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/migrate-users/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;sql&lt;/code&gt; 處理器、名稱正規化、&lt;code&gt;[accounts]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;users&lt;/code&gt;（多一欄 &lt;code&gt;origin&lt;/code&gt; 記來源）、&lt;code&gt;user_reply&lt;/code&gt;、&lt;code&gt;accounting&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/2_imported_users.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;八個示範帳號，各用一種舊格式&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;怎麼運作&#34;&gt;怎麼運作&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;sql&lt;/code&gt; 處理器的 &lt;code&gt;user_query&lt;/code&gt; 回傳密碼欄。密碼欄的開頭用 &lt;code&gt;{格式}&lt;/code&gt; 標明它是什麼：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{SSHA}ZvqZAfdyjd1PQiq8rurmdodN8ihkZW1vc2FsdA==&#xA;{crypt}$1$demosalt$EhA8qeu4qSun8gh9DajmS1&#xA;{nthash}9d232eea31049319fc8ab84300855a34&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;登入時 rradius 依前綴用對應的算法，把使用者輸入的密碼算一次、和存的值比對。所以&lt;strong&gt;同一張表裡可以混用各種格式&lt;/strong&gt;，一個帳號一種。&lt;/p&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/migrate-users/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;本機測試時把 &lt;code&gt;nas&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;。示範帳號的密碼都是「帳號-password」：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;S&lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt;nas-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest ldap1 ldap1-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S     &lt;span style=&#34;color:#75715e&#34;&gt;# {SSHA}&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest shell1 shell1-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S   &lt;span style=&#34;color:#75715e&#34;&gt;# {crypt} 的 MD5-crypt&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest mail1 mail1-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S     &lt;span style=&#34;color:#75715e&#34;&gt;# {NS-MTA-MD5}&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;EXAMPLE\LDAP1@example.com&amp;#39;&lt;/span&gt; ldap1-password 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; $S   &lt;span style=&#34;color:#75715e&#34;&gt;# 名稱會先統一成 ldap1&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;都會收到 Access-Accept。&lt;/p&gt;&#xA;&lt;h2 id=&#34;舊資料對應到哪個格式&#34;&gt;舊資料對應到哪個格式&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;舊系統裡的樣子&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;存成&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;示範帳號&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;LDAP 的 &lt;code&gt;userPassword&lt;/code&gt;，已經是 &lt;code&gt;{SSHA}...&lt;/code&gt;、&lt;code&gt;{SSHA512}...&lt;/code&gt;、&lt;code&gt;{SHA}...&lt;/code&gt;、&lt;code&gt;{MD5}...&lt;/code&gt;、&lt;code&gt;{SMD5}...&lt;/code&gt; 這類&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原樣複製&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;ldap1、ldap2&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;OpenLDAP 的 &lt;code&gt;{PBKDF2-SHA256}次數$鹽$雜湊&lt;/code&gt;（還有 &lt;code&gt;-SHA1&lt;/code&gt;、&lt;code&gt;-SHA512&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原樣複製&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;ldap3&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;{X-PBKDF2}HMACSHA2+256:次數:鹽:雜湊&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原樣複製&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;ldap4&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;/etc/shadow&lt;/code&gt; 的第二欄（&lt;code&gt;$1$...&lt;/code&gt;、&lt;code&gt;$5$...&lt;/code&gt;、&lt;code&gt;$6$...&lt;/code&gt;、&lt;code&gt;$2b$...&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;前面加 &lt;code&gt;{crypt}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;shell1&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;LDAP 的 &lt;code&gt;{CRYPT}$6$...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原樣複製（前綴不分大小寫）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;舊郵件伺服器的 &lt;code&gt;{NS-MTA-MD5}...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原樣複製&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;mail1&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料庫裡十六進位的 MD5、SHA-1、SHA-256（沒有鹽）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;轉成 Base64，加 &lt;code&gt;{MD5}&lt;/code&gt;、&lt;code&gt;{SHA}&lt;/code&gt;、&lt;code&gt;{SHA256}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;old1&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NT hash（32 個十六進位字元）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;前面加 &lt;code&gt;{nthash}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;win1&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;argon2 的 &lt;code&gt;$argon2id$...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;前面加 &lt;code&gt;{argon2}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;明文&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原樣；值本身以 &lt;code&gt;{&lt;/code&gt; 開頭時加 &lt;code&gt;{clear}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;strong&gt;十六進位轉 Base64：&lt;/strong&gt; 舊資料庫常把雜湊存成十六進位字串，rradius 的 &lt;code&gt;{MD5}&lt;/code&gt;、&lt;code&gt;{SHA}&lt;/code&gt; 這一類要 Base64：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;printf &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;%s&amp;#39;&lt;/span&gt; 91f881a968b893e4092eca12a52293ef | xxd -r -p | base64&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;# kfiBqWi4k+QJLsoSpSKT7w==     →  存成 {MD5}kfiBqWi4k+QJLsoSpSKT7w==&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;加鹽的雜湊，鹽要在後面。&lt;/strong&gt; &lt;code&gt;{SSHA}&lt;/code&gt; 這一類是「雜湊接著鹽」一起做 Base64，算法是 &lt;code&gt;雜湊(密碼 + 鹽)&lt;/code&gt;。舊系統是 &lt;code&gt;雜湊(鹽 + 密碼)&lt;/code&gt;、或用別的方式混合時，沒有對應的格式，這些帳號只能重設密碼。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不確定對不對時，先拿一個知道密碼的測試帳號試。&lt;/strong&gt; 格式不對的值一律比對不過，不會放行任何人，所以可以放心試。&lt;/li&gt;&#xA;&lt;li&gt;完整的格式清單見 usage 第 5 節。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;能搬的和不能搬的&#34;&gt;能搬的和不能搬的&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;雜湊只能用在會把明文密碼送到伺服器的登入方式。&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;登入方式&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;能用雜湊嗎&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PAP（VPN、多數 NAS 的網頁登入、TACACS+ 的 PAP 和 ASCII）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;全部格式都可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP-TTLS 內層 PAP（Wi-Fi）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;全部格式都可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CHAP（PPPoE 常用）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;只能明文&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;MS-CHAPv2、PEAP（Wi-Fi 最常見的帳號密碼方式）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;只能明文或 &lt;code&gt;{nthash}&lt;/code&gt;&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;所以：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;舊系統有存 NT hash，&lt;/strong&gt; 搬過來的帳號可以直接用 PEAP（示範的 win1）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;舊系統只有其他雜湊，而 Wi-Fi 要用帳號密碼，&lt;/strong&gt; 有兩條路：Wi-Fi 改用 EAP-TTLS 內層 PAP（各作業系統的支援程度不同，要先確認）；或要求使用者改一次密碼，改的時候存成 &lt;code&gt;{nthash}&lt;/code&gt;（見下面）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;PPPoE 的 CHAP，&lt;/strong&gt; 沒有明文就沒辦法，只能重設。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;自動測試確認了八個示範帳號都能用 PAP 登入，而 &lt;code&gt;{SSHA}&lt;/code&gt; 的帳號用 CHAP 會被拒絕。&lt;/p&gt;&#xA;&lt;h2 id=&#34;匯入&#34;&gt;匯入&#xA;&lt;/h2&gt;&lt;p&gt;把舊系統匯出的資料轉成一個 migration 檔：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-sql&#34; data-lang=&#34;sql&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;-- 2_imported_users.sql&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;INSERT&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;INTO&lt;/span&gt; users (username, password, origin) &lt;span style=&#34;color:#66d9ef&#34;&gt;VALUES&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  (&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;ldap1&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;{SSHA}ZvqZAfdyjd1PQiq8rurmdodN8ihkZW1vc2FsdA==&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;ldap&amp;#39;&lt;/span&gt;),&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  (&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;shell1&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;{crypt}$1$demosalt$EhA8qeu4qSun8gh9DajmS1&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;shadow&amp;#39;&lt;/span&gt;);&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;第一次啟動前就把檔案準備好。&lt;/strong&gt; migration 檔套用後不能再改；之後要補帳號就新增下一個編號的檔案。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;帳號名稱先轉成小寫、去掉網域，&lt;/strong&gt; 和下面的正規化設定一致。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;SQL 的字串裡，單引號要寫兩個。&lt;/strong&gt; 用程式產生這個檔案時，記得處理帳號和雜湊裡的引號。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;origin&lt;/code&gt; 欄&lt;/strong&gt; 不是必要的，範例用它記下每個帳號的密碼來自哪裡，之後好統計還剩多少舊格式。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;檔案很大時&lt;/strong&gt;（幾十萬列），匯入要一些時間，把 &lt;code&gt;[cluster] migrations_wait_ms&lt;/code&gt; 調高到比匯入時間長，見 usage 2.5 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;匯出的檔案裡是所有人的密碼雜湊，&lt;/strong&gt; 弱的雜湊可以被離線破解。傳輸和存放都要保護，匯入後刪掉暫存的副本。migration 檔本身也一樣。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;也可以不用 migration 檔，改用 &lt;code&gt;user add&lt;/code&gt; 一個一個加，但它只接受明文密碼（會自己雜湊），不能用來搬現成的雜湊。&lt;/p&gt;&#xA;&lt;h2 id=&#34;名稱不一致&#34;&gt;名稱不一致&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;username&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;strip_realm&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;both&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;lowercase&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;舊系統的使用者習慣輸入 &lt;code&gt;EXAMPLE\ldap1&lt;/code&gt;、&lt;code&gt;ldap1@example.com&lt;/code&gt; 或 &lt;code&gt;LDAP1&lt;/code&gt;。這個設定在查帳號前把它們都變成 &lt;code&gt;ldap1&lt;/code&gt;：先去掉最後一個反斜線之前的部分，再去掉最後一個 &lt;code&gt;@&lt;/code&gt; 之後的部分，最後轉小寫。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;資料表裡要先統一成小寫。&lt;/strong&gt; 否則 &lt;code&gt;Alice&lt;/code&gt; 這一列永遠查不到。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;原本只差大小寫的兩個帳號會變成同一個。&lt;/strong&gt; 匯入前先找出來處理。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;有依 realm 轉送（&lt;code&gt;[proxy]&lt;/code&gt;）時要小心：&lt;/strong&gt; 帶 &lt;code&gt;@&lt;/code&gt; 的名稱會先比對 realm，符合就轉出去，到不了這裡。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;把舊格式換掉&#34;&gt;把舊格式換掉&#xA;&lt;/h2&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;accounts&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;scheme&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;bcrypt&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;passwd&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE users SET password = ?2, origin = &amp;#39;rradius&amp;#39; WHERE username = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server user passwd --config rradius.toml mail1    &lt;span style=&#34;color:#75715e&#34;&gt;# 問兩次新密碼&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;user passwd&lt;/code&gt; 把新密碼用 &lt;code&gt;scheme&lt;/code&gt; 指定的格式存進去，舊的雜湊就被換掉了；範例順便把 &lt;code&gt;origin&lt;/code&gt; 改成 &lt;code&gt;rradius&lt;/code&gt;。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;scheme&lt;/code&gt; 選哪個：&lt;/strong&gt; 只用 PAP 就用預設的 &lt;code&gt;bcrypt&lt;/code&gt;（登入量很大時改 &lt;code&gt;sha512-crypt&lt;/code&gt;）；要用 PEAP、MS-CHAPv2 選 &lt;code&gt;nthash&lt;/code&gt;；要用 CHAP 只能 &lt;code&gt;clear&lt;/code&gt;。見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e7%94%a8-user-%e6%8c%87%e4%bb%a4&#34; &gt;第 19 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;rradius 不會在登入時自動把舊雜湊換成新的，&lt;/strong&gt; 也沒有讓使用者自己改密碼的介面。要由管理者、或你的入口網站呼叫 &lt;code&gt;user passwd&lt;/code&gt;（密碼從標準輸入給）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;看還剩多少：&lt;/strong&gt; &lt;code&gt;user show &amp;lt;帳號&amp;gt;&lt;/code&gt; 會印出這個帳號的 &lt;code&gt;origin&lt;/code&gt;。rradius 沒有查詢整張資料表的指令；要統計總數，可以在計費腳本裡偶爾用 &lt;code&gt;sql_query&lt;/code&gt; 算一次、用 &lt;code&gt;log()&lt;/code&gt; 寫進記錄（本章沒有附這樣的腳本）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;訂一個期限。&lt;/strong&gt; 期限到了還沒改密碼的帳號，用 migration 檔把密碼設成 &lt;code&gt;NULL&lt;/code&gt;（密碼欄是 &lt;code&gt;NULL&lt;/code&gt; 的帳號一律登不進來），請他們找管理者重設。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;先平行跑一陣子。&lt;/strong&gt; 挑幾台 NAS 指到 rradius，其他的留在舊系統，確認登入結果一致再全部切換。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;舊系統給的回覆屬性&lt;/strong&gt;（VLAN、速率、權限）也要搬，放進 &lt;code&gt;user_reply&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../02-quick-start/#%e8%a8%ad%e5%ae%9a%e8%aa%aa%e6%98%8e&#34; &gt;第 2 章&lt;/a&gt;）。屬性名稱要是 rradius 字典裡的名稱，值的格式不對時登入會被拒絕，所以搬完用 &lt;code&gt;--check&lt;/code&gt; 以外的方式實際登入幾個帳號試。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;舊系統的共用密碼&lt;/strong&gt; 可以沿用，NAS 那邊只要改伺服器位址。趁這次換成每台不同、夠長的更好。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;{crypt}&lt;/code&gt; 和 &lt;code&gt;{argon2}&lt;/code&gt; 的驗證刻意很慢，&lt;/strong&gt; 同時登入很多時會排隊。PBKDF2 的次數很高時也一樣。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有測過的：&lt;/strong&gt; 從任何一套特定的舊系統實際匯出再匯入的流程。示範的雜湊是用 Python 的 &lt;code&gt;hashlib&lt;/code&gt; 和 &lt;code&gt;openssl passwd&lt;/code&gt; 依各格式的定義算出來的，再由情境測試確認 rradius 驗證得過；專案另外用 OpenLDAP 實際產生的值測過 PBKDF2 這幾種格式。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;搬過來的帳號密碼正確卻被拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;前綴不對（例如十六進位的 MD5 直接加了 &lt;code&gt;{MD5}&lt;/code&gt;，沒有轉 Base64）；鹽的位置和格式定義不同；或匯入時雜湊被截斷、多了空白&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只有名稱有大寫的帳號登不進來&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;開了 &lt;code&gt;lowercase&lt;/code&gt;，但資料表裡的名稱沒有轉小寫&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PAP 可以，Wi-Fi 的 PEAP 不行&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PEAP 要明文或 &lt;code&gt;{nthash}&lt;/code&gt;，其他雜湊做不到&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PAP 可以，PPPoE 的 CHAP 不行&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CHAP 要明文&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帶 &lt;code&gt;@&lt;/code&gt; 的名稱沒有回應或被轉走&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;符合 &lt;code&gt;[proxy]&lt;/code&gt; 的某個 realm，轉給上游了&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;登入尖峰時變慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;bcrypt、argon2 或次數很高的 PBKDF2 在排隊。改密碼時換成 &lt;code&gt;sha512-crypt&lt;/code&gt;，或接受這個速度&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動時 &lt;code&gt;migration file ... changed after it was applied&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;改了已經套用的匯入檔。要補資料就新增下一個編號的檔案&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>18. 帳號在別的系統：用 HTTP API 驗證</title>
            <link>https://embark.systems/rradius/18-external-api/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/18-external-api/</guid>
            <description>&lt;p&gt;&lt;strong&gt;情境：&lt;/strong&gt; 旅館、共同工作空間或會員制場所的 Wi-Fi。帳號和密碼已經在會員系統（或訂房系統、帳務系統）裡，那個系統有 HTTP API。不想把帳號複製一份到 rradius 再想辦法同步。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;每次登入，rradius 用 HTTPS 問會員系統「這組帳號密碼對不對」。&lt;/li&gt;&#xA;&lt;li&gt;會員系統順便回答這個人的方案，rradius 轉成屬性交給 NAS。&lt;/li&gt;&#xA;&lt;li&gt;rradius 不存任何帳號；計費照樣記在 rradius 自己的資料表。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;範例目錄：&lt;code&gt;rradius-server/examples/scenarios/external-api/&lt;/code&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檔案&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;內容&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius.toml&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[lua.http]&lt;/code&gt; 和只有一個 &lt;code&gt;lua&lt;/code&gt; 處理器的串接&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;member-api.lua&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;呼叫 API 的腳本&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;migrations/1_schema.sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只有 &lt;code&gt;accounting&lt;/code&gt; 表&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;步驟&#34;&gt;步驟&#xA;&lt;/h2&gt;&lt;p&gt;範例的 API 位址（&lt;code&gt;members.example.com&lt;/code&gt;）是假的，直接啟動後每次登入都會因為連不上而被拒絕。要換成你的系統：&lt;/p&gt;&#xA;&lt;ol&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;在 &lt;code&gt;rradius.toml&lt;/code&gt; 的 &lt;code&gt;[lua.http] allowed_hosts&lt;/code&gt; 填你的 API 主機。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;在 &lt;code&gt;member-api.lua&lt;/code&gt; 改 &lt;code&gt;API&lt;/code&gt;（網址）、&lt;code&gt;API_KEY&lt;/code&gt;（金鑰），並依你的 API 調整請求和回應的處理。&lt;/p&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;檢查並啟動：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;cd rradius-server&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --check --config examples/scenarios/external-api/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;./target/release/rradius-server --config examples/scenarios/external-api/rradius.toml&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&#xA;&lt;li&gt;&#xA;&lt;p&gt;本機測試時把 &lt;code&gt;hotspot&lt;/code&gt; 的 &lt;code&gt;address&lt;/code&gt; 改成 &lt;code&gt;127.0.0.1&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;radtest &amp;lt;帳號&amp;gt; &amp;lt;密碼&amp;gt; 127.0.0.1 &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; hotspot-shared-secret-change-me&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;p&gt;自動測試在本機開一個假的會員系統，把腳本裡的網址指過去，確認：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;情況&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;API 回 200，標頭 &lt;code&gt;X-Plan: gold&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Accept，&lt;code&gt;Filter-Id = &amp;quot;gold&amp;quot;&lt;/code&gt;、&lt;code&gt;Session-Timeout = 14400&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號和密碼裡有 &lt;code&gt;&amp;amp;&lt;/code&gt;、&lt;code&gt;=&lt;/code&gt;、空白&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;編碼後送出，API 收到的是正確的值&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;API 回 401&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CHAP 登入&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Access-Reject：沒有明文密碼可以交給 API&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;API 一直不回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;等到 &lt;code&gt;timeout_ms&lt;/code&gt; 後 Access-Reject，記錄 &lt;code&gt;member API gave no answer&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;腳本假設的-api&#34;&gt;腳本假設的 API&#xA;&lt;/h2&gt;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;POST https://members.example.com/v1/radius/login&#xA;Authorization: Bearer &amp;lt;API 金鑰&amp;gt;&#xA;Content-Type: application/x-www-form-urlencoded&#xA;&#xA;username=&amp;lt;帳號&amp;gt;&amp;amp;password=&amp;lt;密碼&amp;gt;&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;回應&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;意思&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;200，標頭 &lt;code&gt;X-Plan: &amp;lt;方案&amp;gt;&lt;/code&gt;（選填）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號密碼正確，可以上網&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;401、403&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號密碼不對，或現在不能上網&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;其他&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;當成故障，拒絕並記錄狀態碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;strong&gt;腳本裡沒有 JSON 函式。&lt;/strong&gt; 所以範例讓 API 用狀態碼和回應標頭回答，請求用表單編碼。你的 API 只會 JSON 時：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;請求可以自己組字串（值要自己跳脫引號和反斜線，不建議），或請 API 那邊加一個接受表單編碼的端點。&lt;/li&gt;&#xA;&lt;li&gt;回應要從 JSON 裡取值的話，只能用 Lua 的字串比對（&lt;code&gt;string.match&lt;/code&gt;）。簡單的固定格式還可以，結構複雜就不可靠。&lt;/li&gt;&#xA;&lt;li&gt;最穩當的是在會員系統前面放一個很薄的轉接服務，或直接替 RADIUS 開一個專用的端點。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;設定說明&#34;&gt;設定說明&#xA;&lt;/h2&gt;&lt;h3 id=&#34;允許腳本連到哪裡&#34;&gt;允許腳本連到哪裡&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;lua&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;http&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;allowed_hosts&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;members.example.com&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;timeout_ms&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;1500&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;max_concurrent&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;64&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有這個區段，腳本裡就沒有 &lt;code&gt;http_request&lt;/code&gt;。&lt;/strong&gt; 有了之後也只能連 &lt;code&gt;allowed_hosts&lt;/code&gt; 列出的主機，完全比對主機和埠，不支援萬用字元。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只寫主機名稱：&lt;/strong&gt; 只允許 HTTPS 的 443 埠。其他埠寫成 &lt;code&gt;&amp;quot;billing.internal:8443&amp;quot;&lt;/code&gt;。要用沒有加密的 HTTP（只建議在本機或隔離的網路），寫成 &lt;code&gt;&amp;quot;http://legacy.internal:8080&amp;quot;&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;timeout_ms&lt;/code&gt;&lt;/strong&gt; 是從連線到讀完回應的總時間。&lt;strong&gt;一定要比 NAS 的重送時間短，&lt;/strong&gt; 否則 NAS 已經放棄了，rradius 還在等。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;max_concurrent&lt;/code&gt;：&lt;/strong&gt; 同一台主機同時最多幾個請求在等。超過時 &lt;code&gt;http_request&lt;/code&gt; 立刻回傳失敗（&lt;code&gt;busy&lt;/code&gt;），不會排隊。登入和計費分開算。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;內部 CA 簽的憑證&lt;/strong&gt; 用 &lt;code&gt;ca_file&lt;/code&gt; 指定。伺服器憑證一律驗證，沒有關閉驗證的選項。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;串接&#34;&gt;串接&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[[&lt;span style=&#34;color:#a6e22e&#34;&gt;auth&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;handlers&lt;/span&gt;]]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;type&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;script&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;member-api.lua&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;verifies_password&lt;/span&gt; = &lt;span style=&#34;color:#66d9ef&#34;&gt;true&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;verifies_password = true&lt;/code&gt;&lt;/strong&gt; 告訴 rradius「這個腳本真的比對過密碼」。一般的 PAP 登入不需要它；但要讓 Wi-Fi 的 EAP-TTLS 內層 PAP 走這個腳本時一定要設，否則腳本回 &lt;code&gt;accept&lt;/code&gt; 會被當成拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只有帶明文密碼的登入方式能用：&lt;/strong&gt; PAP，和 EAP-TTLS 的內層 PAP。CHAP、MS-CHAPv2、PEAP 送來的不是密碼本身，API 無從比對。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;腳本&#34;&gt;腳本&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-lua&#34; data-lang=&#34;lua&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;local&lt;/span&gt; response, problem &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; http_request{&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  url &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; API,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  method &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;POST&amp;#39;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  headers &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; {&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;    Authorization &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;Bearer &amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;..&lt;/span&gt; API_KEY,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;    [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;Content-Type&amp;#39;&lt;/span&gt;] &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;application/x-www-form-urlencoded&amp;#39;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  },&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  body &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;username=&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;..&lt;/span&gt; url_encode(user) &lt;span style=&#34;color:#f92672&#34;&gt;..&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;&amp;amp;password=&amp;#39;&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;..&lt;/span&gt; url_encode(password),&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;}&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;if&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;not&lt;/span&gt; response &lt;span style=&#34;color:#66d9ef&#34;&gt;then&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  log(&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;member API gave no answer:&amp;#39;&lt;/span&gt;, problem)&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#66d9ef&#34;&gt;return&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;reject&amp;#39;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;end&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;http_request&lt;/code&gt; 的回傳：&lt;/strong&gt; 有收到回應就是一個表（&lt;code&gt;status&lt;/code&gt;、&lt;code&gt;body&lt;/code&gt;、&lt;code&gt;headers&lt;/code&gt;，標頭名稱是小寫），4xx 和 5xx 也算收到。沒收到（逾時、連不上、不在白名單、回應太大、太忙）時回傳 &lt;code&gt;nil&lt;/code&gt; 和原因。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;來自使用者的值一律用 &lt;code&gt;url_encode&lt;/code&gt;。&lt;/strong&gt; 帳號和密碼是使用者輸入的，不編碼的話，名稱裡放一個 &lt;code&gt;&amp;amp;&lt;/code&gt; 就能多塞一個參數給 API。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;放進網址路徑時更要小心：&lt;/strong&gt; &lt;code&gt;url_encode&lt;/code&gt; 遇到空字串、&lt;code&gt;.&lt;/code&gt;、&lt;code&gt;..&lt;/code&gt; 會讓腳本出錯（請求被拒絕），因為 &lt;code&gt;..&lt;/code&gt; 當成路徑會走到別的端點。範例把值放在請求內容裡，名稱剛好是 &lt;code&gt;.&lt;/code&gt; 或 &lt;code&gt;..&lt;/code&gt; 的登入一樣會因為腳本出錯而被拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;API 沒有回答時怎麼辦，由腳本決定。&lt;/strong&gt; 範例拒絕。也可以放行（例如旅館寧可讓客人先上網），但那等於 API 一掛，任何密碼都能通過，要想清楚。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不要記錄密碼。&lt;/strong&gt; 範例的 &lt;code&gt;log()&lt;/code&gt; 只寫原因和狀態碼。rradius 自己的記錄不會寫網址路徑、標頭或內容，只有主機和錯誤的種類。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;API 金鑰寫在腳本裡，&lt;/strong&gt; 所以腳本檔案只讓執行 rradius 的帳號讀得到。換金鑰時改檔案並送 SIGHUP。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;回應裡的值也要檢查。&lt;/strong&gt; 範例只接受看起來像名稱的 &lt;code&gt;X-Plan&lt;/code&gt;，再放進 &lt;code&gt;Filter-Id&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;api-變慢或停擺時&#34;&gt;API 變慢或停擺時&#xA;&lt;/h2&gt;&lt;p&gt;每次登入都要等 API，所以 API 的速度就是登入的速度。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;API 停擺：&lt;/strong&gt; 每次登入等到 &lt;code&gt;timeout_ms&lt;/code&gt; 才被拒絕。同時在等的登入最多 &lt;code&gt;max_concurrent&lt;/code&gt; 個，再多的立刻被拒絕，所以不會把 rradius 自己的名額占滿。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;看指標：&lt;/strong&gt; &lt;code&gt;rradius_script_http_requests_total{result=&amp;quot;timeout&amp;quot;}&lt;/code&gt;、&lt;code&gt;{result=&amp;quot;error&amp;quot;}&lt;/code&gt;、&lt;code&gt;{result=&amp;quot;busy&amp;quot;}&lt;/code&gt; 增加就是 API 有問題；&lt;code&gt;{result=&amp;quot;ok&amp;quot;}&lt;/code&gt; 是收到回應的次數（包含 401）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;NAS 重送：&lt;/strong&gt; 同一個請求還在處理時，NAS 的重送會被丟棄，不會多問 API 一次。處理完 10 秒內的重送直接回上次的答案。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;rradius 不會記住上次的答案。&lt;/strong&gt; 每次登入都問一次。要減輕 API 的負擔，可以在腳本裡把「通過」記進 rradius 的資料表幾分鐘（&lt;code&gt;sql_execute&lt;/code&gt;），之後先查表；但密碼不能明文存，這個做法要自己設計，範例沒有做。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;腳本的執行時限&lt;/strong&gt;（&lt;code&gt;[lua] max_execution_ms&lt;/code&gt;）不算等 API 的時間。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;計費也要通知-api-嗎&#34;&gt;計費也要通知 API 嗎&#xA;&lt;/h2&gt;&lt;p&gt;範例的計費只寫進本機資料表。要在使用者上線、下線時通知會員系統，可以在計費腳本裡也呼叫 &lt;code&gt;http_request&lt;/code&gt;，但要注意：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費腳本回 &lt;code&gt;accept&lt;/code&gt; 才會回覆 NAS。&lt;/strong&gt; API 沒回應時腳本若出錯，NAS 會重送，腳本會再跑一次；API 要能容忍同一筆通知收到兩次。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不要讓 API 的故障擋住計費。&lt;/strong&gt; 比較穩的做法是計費照常寫進資料表、回 &lt;code&gt;accept&lt;/code&gt;，由另一個程式從資料表把資料送給會員系統。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;上線前&#34;&gt;上線前&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;API 那邊要限制來源和速率。&lt;/strong&gt; rradius 會把任何人在登入頁輸入的帳號密碼轉給 API，所以猜密碼的流量也會過去。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;DNS：&lt;/strong&gt; 白名單比對的是主機名稱，不檢查解析出來的位址。DNS 被竄改時，請求可能被送到別的地方；HTTPS 的憑證驗證是這時的保護，所以不要用 &lt;code&gt;http://&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;不跟隨轉址。&lt;/strong&gt; API 回 3xx 時腳本會拿到 3xx。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;多節點：&lt;/strong&gt; 每個節點各自呼叫 API，API 要接受每個節點的來源位址。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;沒有測過的：&lt;/strong&gt; 任何真實的會員系統或帳務系統。情境測試用一個本機的假 API（沒有 TLS），所以 HTTPS 的憑證驗證不在這個測試裡；專案的其他測試涵蓋 &lt;code&gt;http_request&lt;/code&gt; 本身。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;常見問題&#34;&gt;常見問題&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;attempt to call a nil value&lt;/code&gt;，指向 &lt;code&gt;http_request&lt;/code&gt; 那一行&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定檔沒有 &lt;code&gt;[lua.http]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每次登入都被拒絕，記錄有 &lt;code&gt;member API gave no answer: ... is not in lua.http.allowed_hosts&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本裡的主機或埠和 &lt;code&gt;allowed_hosts&lt;/code&gt; 不完全相同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;member API gave no answer&lt;/code&gt;，原因是逾時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;API 太慢或連不到；從節點上用 &lt;code&gt;curl&lt;/code&gt; 試同一個網址&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;原因和憑證有關&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;API 的憑證是內部 CA 簽的，設 &lt;code&gt;ca_file&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_script_http_requests_total{result=&amp;quot;busy&amp;quot;}&lt;/code&gt; 增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同時超過 &lt;code&gt;max_concurrent&lt;/code&gt; 個請求在等：API 太慢，或上限設太低&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PAP 可以，Wi-Fi 不行&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;Wi-Fi 用的是 PEAP 或 MS-CHAPv2，這個做法只能用 EAP-TTLS 內層 PAP，而且處理器要設 &lt;code&gt;verifies_password = true&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;啟動失敗，說沒有可信任的根憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這台主機沒有系統的 CA 憑證（極簡的容器常見），安裝 &lt;code&gt;ca-certificates&lt;/code&gt; 或設 &lt;code&gt;ca_file&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;</description>
        </item><item>
            <title>19. 日常維運</title>
            <link>https://embark.systems/rradius/19-operations/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/19-operations/</guid>
            <description>&lt;p&gt;這一章整理上線之後常做的事。每一項的完整規則在參考文件，這裡只講做法和要注意的地方。出了問題要從現象找原因時，見&lt;a class=&#34;link&#34; href=&#34;../20-troubleshooting/&#34; &gt;第 20 章&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;上線前的檢查清單&#34;&gt;上線前的檢查清單&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 所有 &lt;code&gt;*.secret&lt;/code&gt; 都換成新產生的值（見下方「更換密碼」），檔案權限只有執行 rradius 的帳號讀得到。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 金鑰檔（&lt;code&gt;aka.key&lt;/code&gt;、&lt;code&gt;dpsk.key&lt;/code&gt;、&lt;code&gt;ticket.seal&lt;/code&gt;）是自己產生的、每個節點相同、權限 0600，而且另外備份了。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 憑證不是示範用的；伺服器憑證、NAS 和設備憑證的到期日都納入監控。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 刪掉 &lt;code&gt;migrations/&lt;/code&gt; 裡的示範資料檔案，或在第一次啟動前換成正式資料。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; &lt;code&gt;[[radius.clients]]&lt;/code&gt; 只列真的會來問的設備，不要用 &lt;code&gt;0.0.0.0/0&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; &lt;code&gt;[metrics]&lt;/code&gt; 只綁內部位址；多節點時 &lt;code&gt;[cluster] listen&lt;/code&gt; 綁 WireGuard 或內部網路的位址。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 防火牆只開用到的埠，並限制來源：1812、1813（UDP）、2083（RadSec）、3799（CoA）、49 和 300（TACACS+）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; &lt;code&gt;rradius-server --check --config ...&lt;/code&gt; 通過。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 用 systemd 之類的服務管理器啟動，停止時送 SIGTERM（不要 SIGKILL）並給 30 秒以上，資料目錄和計費暫存的目錄放在持久的本機磁碟。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 設好自動重新啟動（systemd &lt;code&gt;Restart=on-failure&lt;/code&gt;、Docker &lt;code&gt;restart: unless-stopped&lt;/code&gt;）：節點的資料庫壞掉時，rradius 會以狀態碼 1 結束，等重新啟動來恢復（&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 啟動後看記錄，每個要開的埠都有一行 &lt;code&gt;listening&lt;/code&gt;。TACACS+、RadSec、指標的埠綁不了時只記一行錯誤，程序不會結束。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 用實際的設備（不只是 &lt;code&gt;radtest&lt;/code&gt;）各試一次登入、計費，以及會用到的 CoA。&lt;/li&gt;&#xA;&lt;li&gt;&lt;input disabled=&#34;&#34; type=&#34;checkbox&#34;&gt; 監控至少接上「節點活著」（Status-Server）和下面列的幾個指標。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;帳號和資料&#34;&gt;帳號和資料&#xA;&lt;/h2&gt;&lt;p&gt;帳號存在 rradius 自己的資料表時，用 &lt;code&gt;rradius-server user&lt;/code&gt; 指令管理；帳號在別的地方時，讓 rradius 去問那裡：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;做法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;適合&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;怎麼做&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;&lt;code&gt;user&lt;/code&gt; 指令&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號常變動（寬頻用戶、員工、訪客）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius-server user add|passwd|enable|disable|delete|show&lt;/code&gt;，下一次登入就看得到&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;&lt;code&gt;client&lt;/code&gt;、&lt;code&gt;dpsk&lt;/code&gt;、&lt;code&gt;aka&lt;/code&gt; 指令&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;動態 client 的 NAS、每人一把 Wi-Fi 金鑰、SIM 卡&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius-server client|dpsk|aka ...&lt;/code&gt;，SQL 寫在 &lt;code&gt;[accounts.clients]&lt;/code&gt;、&lt;code&gt;[accounts.dpsk]&lt;/code&gt;、&lt;code&gt;[accounts.aka]&lt;/code&gt;（第 12、13、14 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;migration 檔&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;很少變動、想留下變更紀錄的資料（方案、設備、資料表結構）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;新增下一個編號的 SQL 檔，放到每個節點，逐台重啟&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;由現有的目錄驗證&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;公司已經有 AD／LDAP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;ldap&lt;/code&gt; 處理器直接查目錄，rradius 不存帳號（第 5 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;由現有的系統驗證&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號在帳務、會員系統裡&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;在 &lt;code&gt;lua&lt;/code&gt; 處理器用 &lt;code&gt;http_request&lt;/code&gt; 問那個系統的 API（第 18 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;從舊系統搬過來&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;要汰換舊的認證系統&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;把舊的密碼雜湊原樣匯入，使用者不必重設密碼（第 17 章）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h3 id=&#34;用-user-指令&#34;&gt;用 &lt;code&gt;user&lt;/code&gt; 指令&#xA;&lt;/h3&gt;&lt;p&gt;先在設定檔加上 &lt;code&gt;[accounts]&lt;/code&gt;，寫出每個動作對應的 SQL（&lt;code&gt;?1&lt;/code&gt; 是帳號，&lt;code&gt;?2&lt;/code&gt; 是密碼）。以快速開始的 &lt;code&gt;users&lt;/code&gt; 表為例：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;accounts&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;add&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;INSERT INTO users (username, password) VALUES (?1, ?2)&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;passwd&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE users SET password = ?2 WHERE username = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;enable&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE users SET enabled = 1 WHERE username = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;disable&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE users SET enabled = 0 WHERE username = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;delete&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;DELETE FROM users WHERE username = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;show&lt;/span&gt; = &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT username, enabled FROM users WHERE username = ?1&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;不用重啟伺服器，指令每次都讀設定檔。然後：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server user add --config rradius.toml dave        &lt;span style=&#34;color:#75715e&#34;&gt;# 問兩次密碼，不顯示輸入&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server user disable --config rradius.toml carol   &lt;span style=&#34;color:#75715e&#34;&gt;# 停用；user_query 要只查 enabled = 1&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;rradius-server user show --config rradius.toml dave&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;改的是整個叢集，&lt;/strong&gt; 不用逐台處理，也不用重新載入。叢集要在執行，執行指令的主機要連得到節點的 api 埠。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;密碼從標準輸入讀，&lt;/strong&gt; 不會留在 shell 歷史。批次匯入時一行一個帳號，從管線送進去。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;密碼怎麼存由 &lt;code&gt;scheme&lt;/code&gt; 決定：&lt;/strong&gt; 預設 bcrypt；登入量大改 &lt;code&gt;sha512-crypt&lt;/code&gt;；用 CHAP（例如 PPPoE）要 &lt;code&gt;clear&lt;/code&gt;；用 MS-CHAPv2 或 PEAP 要 &lt;code&gt;nthash&lt;/code&gt;。寬頻情境的範例設定用 &lt;code&gt;clear&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;名稱和登入時一樣處理：&lt;/strong&gt; 有 &lt;code&gt;[auth.username]&lt;/code&gt; 時，&lt;code&gt;Dave@Corp&lt;/code&gt; 會依設定存成 &lt;code&gt;dave&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;完整的設定規則、輸出和狀態碼見 usage 2.14 節。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;設定檔要保護好：&lt;/strong&gt; 這些指令用 &lt;code&gt;secret_api&lt;/code&gt; 連到叢集，它等於整個資料庫的鑰匙。只讓管理者讀得到設定檔和密碼檔，並在節點上或經過 WireGuard 執行。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h3 id=&#34;用-migration-檔&#34;&gt;用 migration 檔&#xA;&lt;/h3&gt;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-sql&#34; data-lang=&#34;sql&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;-- 3_plans.sql&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;INSERT&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;INTO&lt;/span&gt; plans (name, max_sessions) &lt;span style=&#34;color:#66d9ef&#34;&gt;VALUES&lt;/span&gt; (&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;family-500m&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#ae81ff&#34;&gt;3&lt;/span&gt;);&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;UPDATE&lt;/span&gt; users &lt;span style=&#34;color:#66d9ef&#34;&gt;SET&lt;/span&gt; enabled &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;WHERE&lt;/span&gt; username &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;carol&amp;#39;&lt;/span&gt;;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;每個檔案只會執行一次，&lt;/strong&gt; 而且套用後不能修改。所以它適合當「變更紀錄」，不適合頻繁改密碼。&lt;/li&gt;&#xA;&lt;li&gt;不要拿其他工具直接連叢集的 api 埠改資料。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;user&lt;/code&gt; 指令只管帳號。&lt;/strong&gt; 動態 client 的 NAS、每人一把的 Wi-Fi 金鑰、SIM 卡各有自己的指令：&lt;code&gt;client&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../14-branch-nas/#%e7%94%a8-client-%e6%8c%87%e4%bb%a4&#34; &gt;第 14 章&lt;/a&gt;）、&lt;code&gt;dpsk&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../12-psk-wifi/#%e6%96%b0%e5%a2%9e%e4%b8%80%e5%80%8b%e4%ba%ba&#34; &gt;第 12 章&lt;/a&gt;）、&lt;code&gt;aka&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../13-sim-wifi/#%e5%8a%a0%e4%b8%80%e5%bc%b5%e5%8d%a1&#34; &gt;第 13 章&lt;/a&gt;），用法和 &lt;code&gt;user&lt;/code&gt; 相同。其他資料表用 migration 檔。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;清除舊資料&#34;&gt;清除舊資料&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;accounting&lt;/code&gt;、&lt;code&gt;tacacs_log&lt;/code&gt; 這類表會一直變大，rradius 不會自動清除。可以在計費腳本裡定期刪除：每小時最多一次，整個叢集只有一個請求會真的去做。&lt;/p&gt;&#xA;&lt;p&gt;先用 migration 建一張記錄時間的表：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-sql&#34; data-lang=&#34;sql&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;-- 3_housekeeping.sql&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;CREATE&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;TABLE&lt;/span&gt; housekeeping (name TEXT &lt;span style=&#34;color:#66d9ef&#34;&gt;PRIMARY&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;KEY&lt;/span&gt;, last_run INTEGER &lt;span style=&#34;color:#66d9ef&#34;&gt;NOT&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;NULL&lt;/span&gt;);&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;INSERT&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;INTO&lt;/span&gt; housekeeping &lt;span style=&#34;color:#66d9ef&#34;&gt;VALUES&lt;/span&gt; (&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;purge-accounting&amp;#39;&lt;/span&gt;, &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt;);&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;在計費腳本 &lt;code&gt;return &#39;accept&#39;&lt;/code&gt; 之前加上：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-lua&#34; data-lang=&#34;lua&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;-- 每小時最多一次：先讀本機副本，不必每個請求都寫入叢集。&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;local&lt;/span&gt; now &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; math.floor(now_unix())&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;local&lt;/span&gt; due &lt;span style=&#34;color:#f92672&#34;&gt;=&lt;/span&gt; sql_query(&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;SELECT 1 FROM housekeeping WHERE name = &amp;#39;purge-accounting&amp;#39; AND last_run &amp;lt; ?&amp;#34;&lt;/span&gt;, {now &lt;span style=&#34;color:#f92672&#34;&gt;-&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;3600&lt;/span&gt;})&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#75715e&#34;&gt;-- 寫入經過叢集，只有一個請求能把 last_run 改成功，它負責刪除。&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;if&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;#&lt;/span&gt;due &lt;span style=&#34;color:#f92672&#34;&gt;&amp;gt;&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;0&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;and&lt;/span&gt; sql_execute(&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;UPDATE housekeeping SET last_run = ? WHERE name = &amp;#39;purge-accounting&amp;#39; AND last_run &amp;lt; ?&amp;#34;&lt;/span&gt;,&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;    {now, now &lt;span style=&#34;color:#f92672&#34;&gt;-&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;3600&lt;/span&gt;}) &lt;span style=&#34;color:#f92672&#34;&gt;==&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt; &lt;span style=&#34;color:#66d9ef&#34;&gt;then&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#75715e&#34;&gt;-- 一次最多刪 10000 列，太多就留到下一個小時，避免一次寫入太久。&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  &lt;span style=&#34;color:#75715e&#34;&gt;-- ORDER BY 讓每個節點刪到同樣的列。&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;  sql_execute(&lt;span style=&#34;color:#e6db74&#34;&gt;[[DELETE FROM accounting WHERE rowid IN&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#e6db74&#34;&gt;    (SELECT rowid FROM accounting WHERE stopped IS NOT NULL AND stopped &amp;lt; ? ORDER BY rowid LIMIT 10000)]]&lt;/span&gt;, {now &lt;span style=&#34;color:#f92672&#34;&gt;-&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;180&lt;/span&gt; &lt;span style=&#34;color:#f92672&#34;&gt;*&lt;/span&gt; &lt;span style=&#34;color:#ae81ff&#34;&gt;86400&lt;/span&gt;})&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;end&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;&#xA;&lt;li&gt;保存多久（範例 180 天）依法規和公司政策決定。業者可能有最短保存期限，&lt;strong&gt;刪除前請先確認&lt;/strong&gt;。&lt;/li&gt;&#xA;&lt;li&gt;刪除在處理一個計費請求時執行，那個請求會晚一點回覆。刪除的量要能在 &lt;code&gt;[lua] query_timeout_ms&lt;/code&gt; 內完成。&lt;/li&gt;&#xA;&lt;li&gt;要保留歷史資料時，先由外部的匯出流程把資料搬走，再刪除。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;重新載入sighup&#34;&gt;重新載入（SIGHUP）&#xA;&lt;/h2&gt;&lt;p&gt;大部分的設定改完送 SIGHUP 就生效，不必重啟：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;kill -HUP &lt;span style=&#34;color:#66d9ef&#34;&gt;$(&lt;/span&gt;pidof rradius-server&lt;span style=&#34;color:#66d9ef&#34;&gt;)&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;systemctl reload rradius        &lt;span style=&#34;color:#75715e&#34;&gt;# 服務檔有 ExecReload=/bin/kill -HUP $MAINPID 時&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;記錄會寫 &lt;code&gt;configuration reloaded from ...&lt;/code&gt;，或 &lt;code&gt;reload failed, keeping the running configuration: ...&lt;/code&gt;（這時繼續用舊設定，修正後再送一次）。&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;改了什麼&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;生效方式&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本、認證串接和名稱正規化、&lt;code&gt;[lua]&lt;/code&gt; 的時限、&lt;code&gt;[lua.http]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RADIUS 和 TACACS+ 的 client 名單、共用密碼檔、TACACS+ 的授權群組和 &lt;code&gt;enable&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP、RadSec、TACACS+ over TLS 的憑證、私鑰、CA 和撤銷清單；&lt;code&gt;[radius.eap]&lt;/code&gt; 的其他設定（只影響新的對話）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[proxy]&lt;/code&gt;（所有上游重新當成正常，DNS 找到的結果清空）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[radius.dynamic_clients]&lt;/code&gt;、&lt;code&gt;[radius.dpsk]&lt;/code&gt;（記住的結果清空）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[[radius.coa.clients]]&lt;/code&gt;、&lt;code&gt;coa_timeout_ms&lt;/code&gt;、&lt;code&gt;coa_attempts&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[log.trace]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;字典、&lt;code&gt;[cluster]&lt;/code&gt;（含新的 migration）、&lt;code&gt;[log]&lt;/code&gt; 的其他設定、&lt;code&gt;[metrics]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重啟&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;所有監聽位址和埠；新增或移除 &lt;code&gt;[radius]&lt;/code&gt;、&lt;code&gt;[radius.tls]&lt;/code&gt;、&lt;code&gt;[radius.coa]&lt;/code&gt;、&lt;code&gt;[tacacs]&lt;/code&gt;、&lt;code&gt;[tacacs.tls]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重啟&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同時處理的上限（&lt;code&gt;max_auth_inflight&lt;/code&gt;、&lt;code&gt;max_acct_inflight&lt;/code&gt;、&lt;code&gt;max_connections&lt;/code&gt;）、&lt;code&gt;idle_timeout_ms&lt;/code&gt;、&lt;code&gt;[lua] max_memory_mb&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重啟&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;兩個計費暫存（&lt;code&gt;[radius.accounting_spool]&lt;/code&gt;、&lt;code&gt;[proxy.accounting_spool]&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重啟&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;要重啟的設定改了時，&lt;/strong&gt; SIGHUP 會在記錄列出它們（&lt;code&gt;these need a restart to apply: ...&lt;/code&gt;），其他的照常套用。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;全部正確才會套用。&lt;/strong&gt; 有一項錯，整份維持原狀，服務不中斷。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;進行中的請求用舊設定做完。&lt;/strong&gt; 已開啟的 TACACS+ 和 RadSec 連線不會斷，但下一個封包依新名單處理：client 被移除時連線關閉。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;SIGHUP 也是「清掉記住的東西」的方法：&lt;/strong&gt; 動態 client、每人一把密碼對上的金鑰、DNS 找到的上游、沒有 &lt;code&gt;shared_tickets&lt;/code&gt; 時的 TLS session，都會清空。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;完整的清單見 usage 2.9 節。&lt;strong&gt;每個節點各自重新載入，&lt;/strong&gt; 叢集要對每一台更新檔案並送信號。&lt;/p&gt;&#xA;&lt;h2 id=&#34;更換密碼&#34;&gt;更換密碼&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;密碼&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;怎麼換&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 的共用密碼（&lt;code&gt;secret_file&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;一台一台換：先改 NAS 那邊，再改 rradius 的檔案並送 SIGHUP；或反過來，看哪邊可以先改。中間那一段這台 NAS 的請求會失敗。每台 NAS 用不同的密碼，就能一次只影響一台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;ldap.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;先在目錄改服務帳號的密碼，再改檔案並送 SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;raft.secret&lt;/code&gt;、&lt;code&gt;api.secret&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;所有節點要相同，&lt;strong&gt;要整個叢集一起停下來換&lt;/strong&gt;，安排維護時間&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TACACS+ 的共用密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;和 NAS 的相同。SIGHUP 後，已開啟的連線下一個封包就要用新密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游的共用密碼（&lt;code&gt;[[proxy.servers]]&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;和對方約好時間，兩邊一起換，再送 SIGHUP&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;aka.key&lt;/code&gt;、&lt;code&gt;dpsk.key&lt;/code&gt;（保護資料表內容的主金鑰）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;可以不停機：新舊兩把並存（&lt;code&gt;previous_key_file&lt;/code&gt;），把資料重新加密後再拿掉舊的。見&lt;a class=&#34;link&#34; href=&#34;../13-sim-wifi/#%e4%b8%bb%e9%87%91%e9%91%b0&#34; &gt;第 13 章&lt;/a&gt;、&lt;a class=&#34;link&#34; href=&#34;../12-psk-wifi/#%e6%8f%9b%e4%b8%bb%e9%87%91%e9%91%b0&#34; &gt;第 12 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;ticket.seal&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;新舊並存（&lt;code&gt;previous_ticket_seal_file&lt;/code&gt;），見&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/#%e6%8f%9b-ticketseal&#34; &gt;第 15 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;憑證和私鑰&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;換掉檔案後送 SIGHUP。新連線、新對話用新的，已開啟的不受影響&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;產生新密碼：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f92672&#34;&gt;(&lt;/span&gt;umask 077; openssl rand -base64 &lt;span style=&#34;color:#ae81ff&#34;&gt;24&lt;/span&gt; &amp;gt; nas.secret&lt;span style=&#34;color:#f92672&#34;&gt;)&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;共用密碼少於 16 個字元時，啟動、重新載入和 &lt;code&gt;--check&lt;/code&gt; 都會有警告（&lt;code&gt;has a shared secret shorter than 16 octets&lt;/code&gt;），但不會拒絕啟動。有些舊設備限制長度或字元，產生後先確認設備接受。&lt;/p&gt;&#xA;&lt;h2 id=&#34;監控&#34;&gt;監控&#xA;&lt;/h2&gt;&lt;p&gt;&lt;code&gt;[metrics]&lt;/code&gt; 開啟後，&lt;code&gt;GET /metrics&lt;/code&gt; 是 Prometheus 格式。建議先看這幾個：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;指標&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;代表&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;建議&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_responses_total{code=&amp;quot;access_reject&amp;quot;}&lt;/code&gt; 的增加速度&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;登入失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;突然增加：密碼外洩嘗試、目錄故障、設定錯誤&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;unknown_client&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;不認得的來源&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;增加：新設備沒加進名單，或有人在掃描&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;invalid&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;簽章、格式不對&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;增加：共用密碼設錯&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;overload&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;太忙丟棄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;大於 0 就要查：資料庫慢、腳本慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_acct_spool_bytes&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;還沒寫進資料庫的計費&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;持續大於 0：資料庫或叢集有問題&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_cluster_leader&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這台有沒有可用的 leader&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;0 超過幾秒：這台被隔開或叢集沒有多數&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_duplicates_total&lt;/code&gt; 的增加速度&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 在重送&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;持續增加：處理比 NAS 的重送間隔慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_proxy_server_alive&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游是否正常&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;0 就告警&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_proxy_unanswered_total&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有任何上游回應的請求&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;增加：整個 realm 的上游都有問題&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_proxy_acct_spool_bytes&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;等上游恢復的轉送計費&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;持續大於 0：上游還沒恢復&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_acct_spool_rejected_total&lt;/code&gt;、&lt;code&gt;rradius_proxy_acct_spool_rejected_total&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重放時被放棄的計費&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;大於 0 就去看暫存目錄的 &lt;code&gt;rejected.log&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radsec_connections_total{result=&amp;quot;handshake_failed&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RadSec 握手失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;增加：憑證過期、被撤銷，或有人在試&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radsec_connections_open&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;目前的 RadSec 連線數&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;掉到比 NAS 數少：有 NAS 斷線了&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_eap_sessions_total{result=&amp;quot;timeout&amp;quot;}&lt;/code&gt;、&lt;code&gt;{result=&amp;quot;evicted&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒走完的、被擠掉的 802.1X 對話&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;持續增加，見&lt;a class=&#34;link&#34; href=&#34;../20-troubleshooting/#wi-fi8021x&#34; &gt;第 20 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_dynamic_client_lookups_total{result=&amp;quot;not_found&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒登記的來源&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;突然增加：新設備沒登記，或有人在掃描&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_script_http_requests_total{result=&amp;quot;timeout&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本呼叫的 API 逾時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;增加：API 有問題&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_coa_relay_total{result=&amp;quot;failed&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;踢人的請求 NAS 沒回答&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;增加：NAS 的 CoA 設定或網路&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_reload_total{result=&amp;quot;error&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重新載入失敗&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;大於 0 就要看記錄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_log_dropped_lines_total&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄來不及寫&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;增加：記錄的去處太慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;活著與否用 Status-Server 檢查最準確，它走和認證相同的路徑：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;Message-Authenticator=0x00&amp;#39;&lt;/span&gt; | radclient -t &lt;span style=&#34;color:#ae81ff&#34;&gt;2&lt;/span&gt; -r &lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt; 10.99.0.1:1812 status &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;&lt;/span&gt;&lt;span style=&#34;color:#66d9ef&#34;&gt;$(&lt;/span&gt;cat nas.secret&lt;span style=&#34;color:#66d9ef&#34;&gt;)&lt;/span&gt;&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;全部指標見 usage 2.8 節。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;數值從啟動開始累計，&lt;/strong&gt; 每個節點各算各的，重新載入不會歸零。告警要看增加的速度，不是絕對值。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;/metrics&lt;/code&gt; 沒有認證也沒有 TLS，&lt;/strong&gt; 只綁內部位址。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;太忙的時候會發生什麼&#34;&gt;太忙的時候會發生什麼&#xA;&lt;/h2&gt;&lt;p&gt;rradius 太忙時不會回錯誤，而是&lt;strong&gt;不回應&lt;/strong&gt;，讓 NAS 重送或改用備援：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;同時處理的請求有上限：&lt;/strong&gt; 登入 &lt;code&gt;max_auth_inflight&lt;/code&gt;、計費 &lt;code&gt;max_acct_inflight&lt;/code&gt;，預設各 4096，分開計算，所以計費暴增不會占掉登入的名額。超過的封包直接丟棄，記錄每秒最多一行 &lt;code&gt;RADIUS ... overloaded: discarded N packets&lt;/code&gt;，&lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;overload&amp;quot;}&lt;/code&gt; 增加。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;NAS 的重送不會重做一次：&lt;/strong&gt; 同一個請求還在處理時，重送的封包丟棄；處理完 10 秒內的重送直接回上次的答案，不再查資料庫或目錄。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;調高上限通常沒有用。&lt;/strong&gt; 合適的值大約是「每秒處理量 × NAS 的重送逾時」，再大也只是讓更多請求排到 NAS 已經放棄。出現過載時，先找出是什麼讓每個請求變慢（資料庫、目錄、上游、API、密碼雜湊），見&lt;a class=&#34;link&#34; href=&#34;../20-troubleshooting/#%e7%99%bb%e5%85%a5%e5%be%88%e6%85%a2%e6%88%96%e6%99%82%e5%a5%bd%e6%99%82%e5%a3%9e&#34; &gt;第 20 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;TACACS+ 和 RadSec&lt;/strong&gt; 用連線數當上限（&lt;code&gt;max_connections&lt;/code&gt;，預設各 1024），超過時新連線立刻關閉。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;Linux 上&lt;/strong&gt; 每個 UDP 埠預設開和 CPU 數一樣多的接收 socket；專門跑 rradius 的實體機還可以開 &lt;code&gt;[runtime] pin_threads = true&lt;/code&gt;。其他平台只有一個 socket。見 usage 2.4 節。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;計費暫存的日常&#34;&gt;計費暫存的日常&#xA;&lt;/h2&gt;&lt;p&gt;設了 &lt;code&gt;[radius.accounting_spool]&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../07-broadband/#%e8%a8%88%e8%b2%bb%e6%9a%ab%e5%ad%98&#34; &gt;第 7 章&lt;/a&gt;）或 &lt;code&gt;[proxy.accounting_spool]&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../11-roaming/#%e4%b8%8a%e6%b8%b8%e5%85%a8%e6%8e%9b%e6%99%82%e6%9a%ab%e5%ad%98%e8%a8%88%e8%b2%bb&#34; &gt;第 11 章&lt;/a&gt;）之後：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;要做的事&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;做法&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;知道現在有沒有落後&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_acct_spool_bytes&lt;/code&gt;、&lt;code&gt;rradius_proxy_acct_spool_bytes&lt;/code&gt; 大於 0 就是有。持續不降就告警&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;估計能撐多久&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每筆約一百多個位元組加上 NAS 送的屬性。預設上限 1 GiB，滿了之後新的計費不回覆，靠 NAS 重送&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;查看被放棄的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;暫存目錄的 &lt;code&gt;rejected.log&lt;/code&gt;：重放時再跑一次結果也一樣的請求（腳本拒絕、SQL 錯誤、client 已不存在）。&lt;strong&gt;不會自動清理，也不會再重放&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;查看損壞的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;.corrupt&lt;/code&gt; 結尾的檔案和 &lt;code&gt;truncated.log&lt;/code&gt;：斷電或磁碟問題留下的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;停機維護&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;SIGTERM 會停止重放，資料留在磁碟，下次啟動繼續&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;換掉節點&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;先等這台的暫存清空（指標為 0）再關機，否則它還沒重放的就留在舊磁碟上&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;改設定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;兩個暫存的設定都要重啟才套用。拿掉一個 &lt;code&gt;[proxy.realms]&lt;/code&gt; 項目前，先確認轉送的暫存是空的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;暫存檔是原始封包，有使用者名稱和位址。目錄權限是 0700，備份和報廢磁碟時一併考慮。&lt;/p&gt;&#xA;&lt;h2 id=&#34;排查某個使用者的問題&#34;&gt;排查某個使用者的問題&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;1. 先看認證紀錄。&lt;/strong&gt; 每次登入一行：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;authentication protocol=&amp;#34;radius&amp;#34; client=&amp;#34;wlc&amp;#34; source=10.30.0.10 user=&amp;#34;Staff1@corp.example.com&amp;#34; account=&amp;#34;staff1&amp;#34; chain=&amp;#34;default&amp;#34; handler=&amp;#34;sql&amp;#34; decision=&amp;#34;reject&amp;#34;&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;code&gt;user&lt;/code&gt; 是設備送來的名稱，&lt;code&gt;account&lt;/code&gt; 是查帳號用的名稱，&lt;code&gt;chain&lt;/code&gt;、&lt;code&gt;handler&lt;/code&gt; 是誰做的決定。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;2. 需要看完整封包時，暫時開追蹤：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-toml&#34; data-lang=&#34;toml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;[&lt;span style=&#34;color:#a6e22e&#34;&gt;log&lt;/span&gt;.&lt;span style=&#34;color:#a6e22e&#34;&gt;trace&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;users&lt;/span&gt; = [&lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#34;staff1&amp;#34;&lt;/span&gt;]&#xA;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#a6e22e&#34;&gt;minutes&lt;/span&gt; = &lt;span style=&#34;color:#ae81ff&#34;&gt;30&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;送 SIGHUP 後，這個使用者的請求和回應會完整寫進記錄（密碼顯示為 &lt;code&gt;&amp;lt;hidden&amp;gt;&lt;/code&gt;），30 分鐘後自動停止。也可以用 &lt;code&gt;clients = [&amp;quot;wlc&amp;quot;]&lt;/code&gt; 追蹤一台設備。&lt;strong&gt;記錄裡會有個人資料，&lt;/strong&gt; 用完就移除這個區段。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;3. 腳本的問題&lt;/strong&gt; 看 &lt;code&gt;Lua script error (&amp;lt;protocol&amp;gt;/&amp;lt;phase&amp;gt;): &amp;lt;檔案&amp;gt;:&amp;lt;行號&amp;gt;: &amp;lt;訊息&amp;gt;&lt;/code&gt;。腳本裡可以用 &lt;code&gt;log(...)&lt;/code&gt; 印出自己的訊息。&lt;/p&gt;&#xA;&lt;p&gt;常見訊息的意思見 usage 第 8 節。&lt;/p&gt;&#xA;&lt;h2 id=&#34;升級&#34;&gt;升級&#xA;&lt;/h2&gt;&lt;ol&gt;&#xA;&lt;li&gt;看新版本的變更說明，特別是標了「升級注意」的項目。&lt;/li&gt;&#xA;&lt;li&gt;用新版本對現有設定跑 &lt;code&gt;--check&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;單機：停止 → 換執行檔 → 啟動。叢集：一次一台，見&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/#%e5%8d%87%e7%b4%9a%e6%88%96%e9%87%8d%e9%96%8b%e6%a9%9f&#34; &gt;第 8 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;/ol&gt;&#xA;&lt;h2 id=&#34;備份&#34;&gt;備份&#xA;&lt;/h2&gt;&lt;p&gt;rradius 沒有內建的備份指令。叢集本身有三份副本，可以撐過一台主機壞掉，但&lt;strong&gt;誤刪的資料會複寫到每一台，&lt;/strong&gt; 所以還是要另外保存：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;帳號的來源要能重建：&lt;/strong&gt; migration 檔放進版本控制；帳號來自目錄或其他系統時，那邊才是正本。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費這類只存在 rradius 的資料，&lt;/strong&gt; 由外部流程定期匯出到帳務系統或資料倉儲。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;金鑰檔不在資料庫裡，要另外備份：&lt;/strong&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;aka.key&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../13-sim-wifi/&#34; &gt;第 13 章&lt;/a&gt;）：遺失就要重新匯入所有卡。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;dpsk.key&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../12-psk-wifi/&#34; &gt;第 12 章&lt;/a&gt;）：遺失就要請每個人重設 Wi-Fi 密碼。&lt;/li&gt;&#xA;&lt;li&gt;&lt;code&gt;ticket.seal&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/&#34; &gt;第 15 章&lt;/a&gt;）：遺失沒有資料損失，重新產生一把，設備做一次完整握手。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;金鑰檔和資料庫的備份分開放。&lt;/strong&gt; 放在一起，拿到備份的人就同時有密文和金鑰。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;設定檔、腳本、憑證&lt;/strong&gt; 放進版本控制或設定管理工具；私鑰和 &lt;code&gt;*.secret&lt;/code&gt; 用你們管理機密的方式另外保存。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;</description>
        </item><item>
            <title>20. 依症狀排查</title>
            <link>https://embark.systems/rradius/20-troubleshooting/</link>
            <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
            <guid>https://embark.systems/rradius/20-troubleshooting/</guid>
            <description>&lt;p&gt;這一章從「看到什麼現象」出發，告訴你先看哪裡。各章結尾的「常見問題」講的是那個情境特有的問題；這裡是跨情境的。訊息的完整對照表在 usage 第 8 節。&lt;/p&gt;&#xA;&lt;h2 id=&#34;先準備好這四樣&#34;&gt;先準備好這四樣&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;工具&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;看什麼&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;怎麼用&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;認證紀錄&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每次登入的結果，和是誰做的決定&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄裡 &lt;code&gt;authentication protocol=...&lt;/code&gt; 開頭的行，預設就有&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;指標&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有留下紀錄的事：被丟棄的封包、過載、上游狀態&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;curl -s http://127.0.0.1:9812/metrics&lt;/code&gt;，要有 &lt;code&gt;[metrics]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;追蹤&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;一個使用者或一台 NAS 的完整請求和回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;[log.trace]&lt;/code&gt; 加 SIGHUP，見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e6%8e%92%e6%9f%a5%e6%9f%90%e5%80%8b%e4%bd%bf%e7%94%a8%e8%80%85%e7%9a%84%e5%95%8f%e9%a1%8c&#34; &gt;第 19 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;strong&gt;&lt;code&gt;--check&lt;/code&gt;&lt;/strong&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定檔、憑證、腳本語法有沒有問題&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius-server --check --config ...&lt;/code&gt;，不影響執行中的服務&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;strong&gt;認證紀錄只記「做了決定」的請求。&lt;/strong&gt; 被丟棄的封包（來源不認得、簽章不對、過載、重送）不會有紀錄，要看指標。這是最常見的誤會：記錄裡什麼都沒有，不代表封包沒到。&lt;/p&gt;&#xA;&lt;h2 id=&#34;nas-送了請求完全沒有回應&#34;&gt;NAS 送了請求，完全沒有回應&#xA;&lt;/h2&gt;&lt;p&gt;rradius 對很多情況刻意不回應（回了反而讓攻擊者得到資訊，或讓 NAS 以為是密碼錯誤）。先看這個指標哪一個標籤在增加：&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;curl -s http://127.0.0.1:9812/metrics | grep -E &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;rradius_radius_(discarded|duplicates|packets)_total&amp;#39;&lt;/span&gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;哪個在增加&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;意思&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;怎麼辦&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;都沒有動&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;封包沒有到 rradius&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;防火牆、路由、NAS 設定的位址和埠；&lt;code&gt;[radius] bind&lt;/code&gt; 是不是只聽了 &lt;code&gt;127.0.0.1&lt;/code&gt;；用 &lt;code&gt;tcpdump -ni any udp port 1812&lt;/code&gt; 確認&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;discarded{reason=&amp;quot;unknown_client&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源位址不在 &lt;code&gt;[[radius.clients]]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;unknown client&lt;/code&gt; 和來源位址。NAS 經過 NAT 時，rradius 看到的是轉換後的位址。用了動態 client 時見&lt;a class=&#34;link&#34; href=&#34;../14-branch-nas/#%e5%b8%b8%e8%a6%8b%e5%95%8f%e9%a1%8c&#34; &gt;第 14 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;discarded{reason=&amp;quot;invalid&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼不對、格式錯誤，或沒帶 Message-Authenticator&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;lacking a Message-Authenticator&lt;/code&gt; 時：舊設備不送這個屬性，在那個 client 設 &lt;code&gt;require_message_authenticator = &amp;quot;no&amp;quot;&lt;/code&gt; 或 &lt;code&gt;&amp;quot;auto&amp;quot;&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../01-concepts/#client%e8%aa%b0%e5%8f%af%e4%bb%a5%e4%be%86%e5%95%8f&#34; &gt;第 1 章&lt;/a&gt;）。否則核對共用密碼，注意檔案結尾有沒有多的空白&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;discarded{reason=&amp;quot;overload&amp;quot;}&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同時處理的請求到上限&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;見下面「登入很慢或時好時壞」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;duplicates&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是重送：原本的請求還在處理&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;處理太慢，NAS 等不及。見下面「登入很慢或時好時壞」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;packets&lt;/code&gt; 有增加，但沒有回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;請求有處理，但決定不回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;依 realm 轉送而上游都沒回應（&lt;a class=&#34;link&#34; href=&#34;../09-realm-proxy/&#34; &gt;第 9 章&lt;/a&gt;）；計費腳本沒有回傳 &lt;code&gt;&#39;accept&#39;&lt;/code&gt;；EAP 的 &lt;code&gt;max_sessions_per_device&lt;/code&gt; 滿了&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;strong&gt;用 Status-Server 分開「網路和密碼」和「帳號」：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;echo &lt;span style=&#34;color:#e6db74&#34;&gt;&amp;#39;Message-Authenticator=0x00&amp;#39;&lt;/span&gt; | radclient -t &lt;span style=&#34;color:#ae81ff&#34;&gt;2&lt;/span&gt; -r &lt;span style=&#34;color:#ae81ff&#34;&gt;1&lt;/span&gt; &amp;lt;位址&amp;gt;:1812 status &amp;lt;共用密碼&amp;gt;&#xA;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;有回應，代表網路通、來源被認得、共用密碼正確，問題在請求本身。沒有回應，問題在前面三樣之一。這個指令要從 client 名單內的主機送。&lt;/p&gt;&#xA;&lt;h2 id=&#34;登入被拒絕&#34;&gt;登入被拒絕&#xA;&lt;/h2&gt;&lt;p&gt;找到那次登入的認證紀錄，看 &lt;code&gt;handler&lt;/code&gt; 和 &lt;code&gt;account&lt;/code&gt;：&lt;/p&gt;&#xA;&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;authentication protocol=&amp;#34;radius&amp;#34; client=&amp;#34;wlc&amp;#34; source=10.30.0.10 user=&amp;#34;Staff1@corp.example.com&amp;#34; account=&amp;#34;staff1&amp;#34; chain=&amp;#34;default&amp;#34; handler=&amp;#34;sql&amp;#34; decision=&amp;#34;reject&amp;#34;&#xA;&lt;/code&gt;&lt;/pre&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;&lt;code&gt;handler&lt;/code&gt;&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;意思&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;常見原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;sql&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;sql&lt;/code&gt; 處理器拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;密碼錯誤；密碼欄是 &lt;code&gt;NULL&lt;/code&gt; 或空的；查到多筆；密碼的格式不能用於這種登入方式（CHAP 要明文，MS-CHAPv2 要明文或 &lt;code&gt;{nthash}&lt;/code&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;ldap&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;ldap&lt;/code&gt; 處理器拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;密碼錯誤、不在 &lt;code&gt;required_groups&lt;/code&gt;；目錄連不上或服務帳號登入失敗時，記錄另有 &lt;code&gt;auth ldap handler:&lt;/code&gt; 開頭的訊息&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;lua&lt;/code&gt;、&lt;code&gt;script&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本的邏輯，或腳本出錯（記錄有 &lt;code&gt;Lua script error&lt;/code&gt;，附檔案和行號）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;none&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;所有處理器都略過&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號不存在（&lt;code&gt;sql&lt;/code&gt; 查不到、&lt;code&gt;ldap&lt;/code&gt; 找不到）。先看 &lt;code&gt;account&lt;/code&gt; 是不是你預期的名稱&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;no_password_check&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;all_accept&lt;/code&gt; 串接裡沒有人比對過密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;帳號不在 &lt;code&gt;sql&lt;/code&gt;、&lt;code&gt;ldap&lt;/code&gt; 裡，只有後面的腳本說可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;normalization&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;名稱被擋在串接之前&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;名稱處理後是空的，或不符合 &lt;code&gt;[auth.username] allowed&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;eap-tls&lt;/code&gt;、&lt;code&gt;eap-peap&lt;/code&gt;、&lt;code&gt;eap-ttls&lt;/code&gt;、&lt;code&gt;eap-aka-prime&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;EAP 對話以拒絕結束&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;前一行通常有 &lt;code&gt;EAP conversation with client ... failed&lt;/code&gt; 或 &lt;code&gt;refused&lt;/code&gt; 和原因，見下面「Wi-Fi（802.1X）」&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;dpsk&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每人一把密碼&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有人的密碼對得上（&lt;code&gt;account&lt;/code&gt; 是空的），或對上了但那個人被停用（&lt;a class=&#34;link&#34; href=&#34;../12-psk-wifi/#%e5%b8%b8%e8%a6%8b%e5%95%8f%e9%a1%8c&#34; &gt;第 12 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;chain=&amp;quot;proxy&amp;quot;&lt;/code&gt; 時的 realm 名稱&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;要到上游那邊查&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;strong&gt;密碼明明正確：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;code&gt;account&lt;/code&gt; 和資料表裡的名稱一樣嗎？大小寫、有沒有帶 realm。見 &lt;code&gt;[auth.username]&lt;/code&gt;（usage 3.6 節）。&lt;/li&gt;&#xA;&lt;li&gt;記錄有 &lt;code&gt;RADIUS response attribute error&lt;/code&gt; 嗎？那是回覆屬性的名稱或值不對（&lt;code&gt;reply_query&lt;/code&gt;、&lt;code&gt;group_reply&lt;/code&gt;、腳本的 &lt;code&gt;set_attr&lt;/code&gt;），這時就算密碼正確也會拒絕。&lt;/li&gt;&#xA;&lt;li&gt;有沒有紀錄根本不是這台 rradius 寫的？多節點時到每一台找。&lt;/li&gt;&#xA;&lt;li&gt;帶 &lt;code&gt;@&lt;/code&gt; 的名稱被 &lt;code&gt;[proxy]&lt;/code&gt; 轉走了嗎？這時 &lt;code&gt;chain&lt;/code&gt; 是 &lt;code&gt;proxy&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;strong&gt;完全找不到這次登入的紀錄：&lt;/strong&gt; 回到上一節，它被丟棄了。或 &lt;code&gt;[log] auth = false&lt;/code&gt; 把紀錄關了。&lt;/p&gt;&#xA;&lt;h2 id=&#34;登入很慢或時好時壞&#34;&gt;登入很慢或時好時壞&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;看什麼&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;代表&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;RADIUS authentication overloaded: discarded N packets&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同時處理的請求到了 &lt;code&gt;max_auth_inflight&lt;/code&gt;（預設 4096）。這是結果，不是原因：有東西讓每個請求變慢了&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_duplicates_total&lt;/code&gt; 增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 在重送，處理時間超過它的重送間隔&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;sql_query timed out&lt;/code&gt;、&lt;code&gt;sql_execute timed out&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;資料庫慢，或叢集沒有多數節點。這樣的登入不回應（&lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;database&amp;quot;}&lt;/code&gt;），NAS 會重送或改問別台&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;auth ldap handler:&lt;/code&gt; 的逾時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;目錄慢或連不上&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_script_http_requests_total{result=&amp;quot;timeout&amp;quot;}&lt;/code&gt; 增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;腳本呼叫的 API 慢（&lt;a class=&#34;link&#34; href=&#34;../18-external-api/#api-%e8%ae%8a%e6%85%a2%e6%88%96%e5%81%9c%e6%93%ba%e6%99%82&#34; &gt;第 18 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_proxy_requests_total{result=&amp;quot;timeout&amp;quot;}&lt;/code&gt; 增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游慢或停擺&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;找出慢的那一段：&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;密碼雜湊：&lt;/strong&gt; bcrypt 和 argon2 刻意很慢，同時驗證的數量不超過 CPU 核心數，其餘排隊。尖峰時每秒幾百次登入就會排隊。登入量大時改用 &lt;code&gt;sha512-crypt&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e7%94%a8-user-%e6%8c%87%e4%bb%a4&#34; &gt;第 19 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;寫入：&lt;/strong&gt; 每次登入都寫資料庫的腳本（配額、IP 配發、兩步驟驗證）要經過叢集，比只讀的慢。叢集剛失去多數節點時，寫入要等 &lt;code&gt;[lua] query_timeout_ms&lt;/code&gt; 才失敗；沒有 leader 超過 5 秒後立刻失敗。這些登入都不回應，不是拒絕。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;第一台上游沒回應：&lt;/strong&gt; 依 realm 轉送時，每個請求先等第一台逾時才換下一台，直到它被判定停擺。設 &lt;code&gt;probe_interval_ms&lt;/code&gt; 可以提早發現（&lt;a class=&#34;link&#34; href=&#34;../11-roaming/#%e5%85%a8%e5%9c%8b%e4%bb%a3%e7%90%86&#34; &gt;第 11 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;調高 &lt;code&gt;max_auth_inflight&lt;/code&gt; 通常沒有用。&lt;/strong&gt; NAS 等幾秒就放棄了，排更長的隊只是讓更多請求白做。先解決變慢的原因。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;計費拖慢登入：&lt;/strong&gt; 同時執行的計費腳本有上限（CPU 核心數減 2），留了執行緒給登入；但兩者共用資料庫，計費腳本很重時登入還是會受影響。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;計費一直重送或計費不見了&#34;&gt;計費一直重送，或計費不見了&#xA;&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;NAS 一直重送同一筆計費：&lt;/strong&gt; 計費腳本沒有回傳 &lt;code&gt;&#39;accept&#39;&lt;/code&gt;，所以 rradius 沒有回覆。&lt;/p&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;記錄有 &lt;code&gt;Lua script error (radius/accounting)&lt;/code&gt;：腳本出錯，看檔案和行號。&lt;/li&gt;&#xA;&lt;li&gt;記錄有 &lt;code&gt;Lua script did not accept accounting&lt;/code&gt;：腳本正常結束但回傳了別的值。不想記錄的封包也要回 &lt;code&gt;&#39;accept&#39;&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;記錄有 &lt;code&gt;sql_execute timed out&lt;/code&gt;：資料庫寫不進去。設定計費暫存後，這種情況會先寫到本機再回覆（&lt;a class=&#34;link&#34; href=&#34;../07-broadband/#%e8%a8%88%e8%b2%bb%e6%9a%ab%e5%ad%98&#34; &gt;第 7 章&lt;/a&gt;）。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;p&gt;&lt;strong&gt;計費少了：&lt;/strong&gt;&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;檢查&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;代表&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_acct_spool_bytes&lt;/code&gt; 大於 0&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;還在暫存裡等重放，還沒進資料庫。資料庫恢復、腳本正常後會自己清空&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;暫存目錄有 &lt;code&gt;rejected.log&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重放時被放棄的請求：腳本拒絕、SQL 語法或約束錯誤、client 已經不存在。檔案不會自動清理，也不會再重放&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;暫存目錄有 &lt;code&gt;.corrupt&lt;/code&gt; 結尾的檔案或 &lt;code&gt;truncated.log&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;斷電或磁碟問題留下的，裡面的請求沒有重放&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_acct_spool_full_total&lt;/code&gt; 增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;暫存滿了或寫入失敗，這些請求沒有回覆，靠 NAS 重送&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;RADIUS accounting overloaded&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;到了 &lt;code&gt;max_acct_inflight&lt;/code&gt;，封包被丟棄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費是轉送出去的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;看 &lt;code&gt;rradius_proxy_acct_spool_*&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../11-roaming/#%e4%b8%8a%e6%b8%b8%e5%85%a8%e6%8e%9b%e6%99%82%e6%9a%ab%e5%ad%98%e8%a8%88%e8%b2%bb&#34; &gt;第 11 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;strong&gt;暫存一直不降（&lt;code&gt;rradius_acct_spool_bytes&lt;/code&gt; 持續大於 0）：&lt;/strong&gt; 重放卡在最前面那一筆。資料庫還沒恢復，或腳本每次都出錯。看記錄裡 &lt;code&gt;Lua script&lt;/code&gt; 和 &lt;code&gt;accounting spool&lt;/code&gt; 開頭的訊息；修好腳本並送 SIGHUP 後會自動繼續。&lt;/p&gt;&#xA;&lt;p&gt;&lt;strong&gt;同一筆計費記了兩次：&lt;/strong&gt; 腳本不能重複執行。NAS 更新 &lt;code&gt;Acct-Delay-Time&lt;/code&gt; 重送時會換新的 Identifier，rradius 認不出是重送；暫存重放也可能重跑。寫入要用 &lt;code&gt;INSERT ... ON CONFLICT&lt;/code&gt; 或 &lt;code&gt;INSERT OR IGNORE&lt;/code&gt;（&lt;a class=&#34;link&#34; href=&#34;../01-concepts/#%e8%a8%88%e8%b2%bb%e8%a6%81%e8%83%bd%e9%87%8d%e8%a4%87%e5%9f%b7%e8%a1%8c&#34; &gt;第 1 章&lt;/a&gt;）。&lt;/p&gt;&#xA;&lt;h2 id=&#34;wi-fi8021x&#34;&gt;Wi-Fi（802.1X）&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;記錄有 &lt;code&gt;EAP conversation with client ... failed&lt;/code&gt;，原因提到 &lt;code&gt;State&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;對話的後半段到了另一個節點。同一次登入要留在同一個節點：NAS 用主備，或負載平衡器依來源固定（&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;... failed&lt;/code&gt;，原因是 TLS 錯誤&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用戶端不信任伺服器憑證而中斷（裝置上沒有 CA、伺服器名稱不符），或 TLS 版本、加密套件不合&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;... refused&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;憑證（或卡片）通過，但名稱不符，或串接沒有接受：&lt;code&gt;certificate_query&lt;/code&gt; 查不到、&lt;code&gt;ldap&lt;/code&gt; 沒設 &lt;code&gt;certificate_filter&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;the chain did not accept the inner name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PEAP、TTLS 的密碼錯誤或查無帳號&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;the chain accepted the inner name without checking a password&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;接受的處理器是沒設 &lt;code&gt;verifies_password&lt;/code&gt; 的 &lt;code&gt;lua&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;this client has no chain to check a password with&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PEAP、TTLS 需要認證串接，這個 client 沒有&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;PEAP 一直失敗，PAP 測試卻可以&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;密碼不是明文或 &lt;code&gt;{nthash}&lt;/code&gt;；或 &lt;code&gt;ldap&lt;/code&gt; 用了 &lt;code&gt;bind&lt;/code&gt; 模式&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用戶端選了你不想給的方法&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;那個 client 的 &lt;code&gt;eap_methods&lt;/code&gt; 列了它。只想收憑證就只列 &lt;code&gt;[&amp;quot;tls&amp;quot;]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_eap_sessions_total{result=&amp;quot;timeout&amp;quot;}&lt;/code&gt; 高&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;用戶端沒有走完：使用者看到憑證警告後取消、訊號不好，或 NAS 的 EAP 逾時太短&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;result=&amp;quot;evicted&amp;quot;&lt;/code&gt; 持續增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同時進行的對話超過 &lt;code&gt;max_sessions&lt;/code&gt; 或 &lt;code&gt;max_sessions_per_client&lt;/code&gt;。所有使用者都經過同一台控制器時，調高後者&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;result=&amp;quot;overload&amp;quot;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;同一台設備同時開太多對話（&lt;code&gt;max_sessions_per_device&lt;/code&gt;），或 EAP-AKA&amp;rsquo; 的頻率限制&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;撤銷、恢復 session 的問題&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../15-wifi-certs/#%e5%b8%b8%e8%a6%8b%e5%95%8f%e9%a1%8c&#34; &gt;第 15 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;strong&gt;看不到內層的名稱：&lt;/strong&gt; PEAP、TTLS 的認證紀錄裡，&lt;code&gt;user&lt;/code&gt; 是外層的匿名名稱，&lt;code&gt;account&lt;/code&gt; 才是真正的帳號。用 &lt;code&gt;[log.trace]&lt;/code&gt; 追蹤時比對的是外層名稱，所以要用 &lt;code&gt;clients = [...]&lt;/code&gt; 追蹤整台 NAS，或列出外層實際用的名稱。&lt;/p&gt;&#xA;&lt;h2 id=&#34;tls-連線radsectacacs-over-tlsradsec-上游&#34;&gt;TLS 連線（RadSec、TACACS+ over TLS、RadSec 上游）&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;RadSec handshake with ... failed&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;對方沒有憑證、憑證不是 &lt;code&gt;client_ca_file&lt;/code&gt; 簽的、已撤銷、過期，或 TLS 版本不合&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;握手成功但馬上被關閉&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;憑證通過了，但比對不到 client：看記錄寫的是 &lt;code&gt;fits no client&lt;/code&gt;、&lt;code&gt;is not valid for client ...&#39;s tls_name&lt;/code&gt;，還是 &lt;code&gt;needs tls_name&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;所有設備同時連不上&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;伺服器憑證過期；&lt;code&gt;crl_file&lt;/code&gt; 缺了一層 CA；&lt;code&gt;ocsp = &amp;quot;hard&amp;quot;&lt;/code&gt; 而 responder 停擺；RadSec 開了 &lt;code&gt;reject_expired_crl&lt;/code&gt; 而 CRL 過期&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;換了憑證或 CRL 沒有生效&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;要送 SIGHUP，而且每個節點都要&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;proxy server ...: cannot connect ... TLS:&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連上游失敗。訊息後半會說是對方的憑證不被 &lt;code&gt;ca_file&lt;/code&gt; 信任、對 &lt;code&gt;tls_name&lt;/code&gt; 無效，還是對方不接受你出示的憑證&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;accepting a connection failed N times&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;檔案描述元用完。調高 &lt;code&gt;ulimit -n&lt;/code&gt;，或調低 &lt;code&gt;max_connections&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;用 &lt;code&gt;openssl s_client&lt;/code&gt; 可以單獨確認握手，見&lt;a class=&#34;link&#34; href=&#34;../10-radsec/#3-%e7%a2%ba%e8%aa%8d%e6%8f%a1%e6%89%8b&#34; &gt;第 10 章&lt;/a&gt;。&lt;/p&gt;&#xA;&lt;h2 id=&#34;依-realm-轉送&#34;&gt;依 realm 轉送&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;no proxy server answered a request for realm ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;上游都沒有合格回應：停擺、防火牆、共用密碼不對，或上游的回應沒帶 Message-Authenticator&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;proxy server ... is not answering on ...&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這台被判定停擺，暫時改用下一台。之後會用 Status-Server 確認它回來了沒有&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;打錯密碼之後上游就被判定停擺&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;timeout_ms&lt;/code&gt; 比上游刻意延遲拒絕的時間短&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;a request for realm ... came back to this server&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;轉送的設定繞成迴圈&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;本機的帳號被轉走了&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;有 &lt;code&gt;*&lt;/code&gt; 或涵蓋自己網域的項目；用 DNS 找上游時沒有把自己的 realm 列在 &lt;code&gt;local_realms&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某個 realm 的請求都被丟棄&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;DNS 查詢失敗（&lt;a class=&#34;link&#34; href=&#34;../11-roaming/#%e5%b8%b8%e8%a6%8b%e5%95%8f%e9%a1%8c&#34; &gt;第 11 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;踢人disconnectcoa&#34;&gt;踢人（Disconnect、CoA）&#xA;&lt;/h2&gt;&lt;p&gt;NAK 的 &lt;code&gt;Error-Cause&lt;/code&gt; 直接說明原因：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;結果&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;意思&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;沒有任何回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;送出端不在 &lt;code&gt;[[radius.coa.clients]]&lt;/code&gt;、共用密碼不對，或同時超過 256 個請求。&lt;code&gt;rradius_coa_relay_discarded_total&lt;/code&gt; 會增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAK 502&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;找不到 NAS：請求裡的 &lt;code&gt;NAS-IP-Address&lt;/code&gt;、&lt;code&gt;NAS-Identifier&lt;/code&gt; 對不到任何 client；或那台只靠憑證辨認的 NAS 沒有連線開著&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAK 503&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;只給了使用者名稱，而 &lt;code&gt;session_query&lt;/code&gt; 查不到開著的 session&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAK 505&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAS 沒有合格的回答（沒開 CoA、埠不對、不接受 rradius 的來源、共用密碼不同）；&lt;code&gt;session_query&lt;/code&gt; 失敗；或請求裡有要加密的屬性&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;NAK 帶其他的 &lt;code&gt;Error-Cause&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;是 NAS 自己的回答，原樣傳回&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;p&gt;&lt;code&gt;send_disconnect&lt;/code&gt;、&lt;code&gt;send_coa&lt;/code&gt; 回傳 &lt;code&gt;&amp;quot;timeout&amp;quot;&lt;/code&gt;，和 &lt;code&gt;rradius-server disconnect&lt;/code&gt; 印出 &lt;code&gt;timeout&lt;/code&gt;，原因和 505 的第一項相同。指令是從執行它的那台主機送出，NAS 要接受那個來源位址。&lt;/p&gt;&#xA;&lt;h2 id=&#34;tacacs&#34;&gt;TACACS+&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;連線馬上被關閉，記錄有 &lt;code&gt;TACACS+ connection from unknown client&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;來源不在 &lt;code&gt;[[tacacs.clients]]&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;認證回 ERROR，記錄有 &lt;code&gt;a body did not decode, so the shared secret may be wrong&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;共用密碼不同。&lt;code&gt;rradius_tacacs_malformed_total&lt;/code&gt; 也會增加&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;能登入，但每個指令都被拒絕&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;授權腳本拒絕，或授權群組沒有任何一條規則成立（&lt;a class=&#34;link&#34; href=&#34;../06-device-admin/#%e5%b8%b8%e8%a6%8b%e5%95%8f%e9%a1%8c&#34; &gt;第 6 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;enable&lt;/code&gt; 一律失敗，記錄有 &lt;code&gt;TACACS+ enable request refused&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;預設拒絕 enable。設備端不要把 rradius 放進 enable 的方法，或設 &lt;code&gt;enable = &amp;quot;login&amp;quot;&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;CHAP、MS-CHAPv2 登入收到 RESTART&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;這個 client 沒有認證串接，或串接裡只有沒設 &lt;code&gt;verifies_password&lt;/code&gt; 的腳本&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;登入一直回 ERROR&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;一條連線上未完成的登入超過 8 個，或一次登入超過 60 秒&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;TACACS+ overloaded: closed N connections&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;到了 &lt;code&gt;max_connections&lt;/code&gt;。設備開了連線不關時，調低 &lt;code&gt;idle_timeout_ms&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;TLS 的問題&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;a class=&#34;link&#34; href=&#34;../16-device-admin-tls/#%e5%b8%b8%e8%a6%8b%e5%95%8f%e9%a1%8c&#34; &gt;第 16 章&lt;/a&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;啟動失敗&#34;&gt;啟動失敗&#xA;&lt;/h2&gt;&lt;p&gt;看結束的狀態碼：&lt;/p&gt;&#xA;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;狀態碼&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;意思&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;常見原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;2&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定有錯，什麼都還沒開始&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;訊息會指出檔案和欄位：欄位拼錯、檔案不存在、腳本語法錯誤、憑證和私鑰不配對、金鑰檔權限太寬、migration 檔名或內容有問題&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;1&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;設定沒問題，但環境不允許&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;RADIUS 的 UDP 埠或 CoA 的埠綁不了（被占用、沒有權限，訊息有位址和埠）；叢集在 &lt;code&gt;migrations_wait_ms&lt;/code&gt; 內沒有就緒（其他節點沒起來、連不到）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;TACACS+、RadSec、指標的埠綁不了時不會結束，&lt;/strong&gt; 只記一行錯誤，其他服務照常。所以 TACACS+ 設了 49 埠卻沒有權限時，程序看起來正常，但設備連不上；啟動後確認記錄裡有每個埠的 &lt;code&gt;listening&lt;/code&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;migration file &#39;...&#39; changed after it was applied&lt;/code&gt;：&lt;/strong&gt; 改了套用過的檔案。改回原本的內容，要變更就新增下一個編號的檔案。開發環境可以停掉伺服器、刪掉 &lt;code&gt;data/&lt;/code&gt; 重來。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;節點反覆以狀態碼 1 結束，記錄有 &lt;code&gt;cluster was not ready to apply migrations&lt;/code&gt;：&lt;/strong&gt; 多數節點還沒上線；或 &lt;code&gt;migrations_wait_ms&lt;/code&gt; 比最慢的 SQL 檔執行時間短。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;一直出現 &lt;code&gt;Raft node has not been initialized&lt;/code&gt;：&lt;/strong&gt; 節點還沒加入叢集。其他節點啟動了嗎？彼此連得到 raft 和 api 的埠嗎？&lt;code&gt;raft.secret&lt;/code&gt; 相同嗎？&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;啟動前先用 &lt;code&gt;--check&lt;/code&gt;&lt;/strong&gt; 可以抓到狀態碼 2 的大部分問題，但它不連資料庫和目錄，SQL 寫錯、LDAP 密碼錯誤要啟動後才知道。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;重新載入沒有生效&#34;&gt;重新載入沒有生效&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;記錄有 &lt;code&gt;reload failed, keeping the running configuration: ...&lt;/code&gt;：&lt;/strong&gt; 新設定有錯，服務繼續用舊的。修正後再送一次 SIGHUP。&lt;code&gt;rradius_reload_total{result=&amp;quot;error&amp;quot;}&lt;/code&gt; 會增加。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;記錄有 &lt;code&gt;these need a restart to apply: ...&lt;/code&gt;：&lt;/strong&gt; 列出的設定改了但要重啟才會套用；其他的已經套用。清單見&lt;a class=&#34;link&#34; href=&#34;../19-operations/#%e9%87%8d%e6%96%b0%e8%bc%89%e5%85%a5sighup&#34; &gt;第 19 章&lt;/a&gt;。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;只有一台生效：&lt;/strong&gt; 每個節點各自重新載入，檔案要放到每一台、信號要送給每一台。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;改了字典檔：&lt;/strong&gt; 字典不會重讀，要重啟。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;改了 migration 目錄：&lt;/strong&gt; 新的檔案只在啟動時套用。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;&lt;h2 id=&#34;叢集&#34;&gt;叢集&#xA;&lt;/h2&gt;&lt;table&gt;&#xA;&#x9;&lt;thead&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;現象&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;th&gt;原因&lt;/th&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/thead&gt;&#xA;&#x9;&lt;tbody&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某台的登入結果和其他台不同&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;那台的 &lt;code&gt;migrations/&lt;/code&gt;、腳本或設定檔和別台不同；或它被隔開了（&lt;code&gt;rradius_cluster_leader&lt;/code&gt; 是 0），讀的是舊資料&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;某台有些登入不回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;rradius_radius_discarded_total{reason=&amp;quot;database&amp;quot;}&lt;/code&gt;：它連不到叢集資料庫；&lt;code&gt;reason=&amp;quot;no_leader&amp;quot;&lt;/code&gt;：設了 &lt;code&gt;stop_without_leader_ms&lt;/code&gt;，它沒有 leader 太久（&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重啟的節點過一陣子才開始回應&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;正常：它等本機副本追上叢集才回應，記錄有 &lt;code&gt;has caught up with the cluster&lt;/code&gt;。停機很久時追得比較久，上限是 &lt;code&gt;migrations_wait_ms&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;剛寫入的資料讀不到&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;&lt;code&gt;sql_query&lt;/code&gt; 讀本機副本，可能比寫入慢一點。判斷寫入有沒有成功用 &lt;code&gt;sql_execute&lt;/code&gt; 的回傳值，不要再查一次&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;寫入都逾時&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;失去多數節點（三台剩一台）。只讀的登入照常，要寫入的登入不回應、TACACS+ 回 ERROR，計費有暫存時進暫存，等節點回來&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;節點自己結束，狀態碼 1，記錄有 &lt;code&gt;exiting so that a restart recovers it&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;它的 Raft 核心停了（常見原因：斷線期間叢集寫入超過 &lt;code&gt;snapshot_every&lt;/code&gt;），或 hiqlite 內部 panic。重新啟動它就會追上；有設自動重啟時不必處理（&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;停止一個節點要等約 10 秒&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;正常：多節點時 hiqlite 關閉前先等 9.5 秒&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;剩一台時重啟，它一直起不來（有 migration 時以狀態碼 1 結束）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;重新啟動的節點要等到有 leader。先讓其他節點回來（&lt;a class=&#34;link&#34; href=&#34;../08-ha-cluster/&#34; &gt;第 8 章&lt;/a&gt;）&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;異常結束後啟動很慢&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;要重播上次快照以來的寫入。見 usage 2.2 節的 &lt;code&gt;snapshot_every&lt;/code&gt;&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&#x9;&#x9;&lt;tr&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;每個節點行為不同的功能&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&lt;td&gt;計費暫存、EAP 對話、沒有 &lt;code&gt;shared_tickets&lt;/code&gt; 的 session、動態 client 和每人一把密碼記住的結果、RadSec 連線、追蹤的計時，都是每個節點自己的&lt;/td&gt;&#xA;&#x9;&#x9;&#x9;&lt;/tr&gt;&#xA;&#x9;&lt;/tbody&gt;&#xA;&lt;/table&gt;&#xA;&lt;h2 id=&#34;記錄本身&#34;&gt;記錄本身&#xA;&lt;/h2&gt;&lt;ul&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;rradius_log_dropped_lines_total&lt;/code&gt; 增加：&lt;/strong&gt; 記錄寫得比輸出的去處快，或寫入失敗（磁碟滿、接收的程序結束）。被丟掉的行就沒有了，服務不受影響。檢查 stderr 接到哪裡；流量很大時關掉 &lt;code&gt;[log] auth&lt;/code&gt;，或不要對整台 NAS 開追蹤。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;結尾是 &lt;code&gt;(N since the last line)&lt;/code&gt; 的訊息：&lt;/strong&gt; 任何人都能觸發的訊息（陌生來源、握手失敗）每種每秒最多一行，N 是這段時間的總數。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;hiqlite&lt;/code&gt; 的 WARN、ERROR：&lt;/strong&gt; 叢集啟動和關閉時會有幾行，例如 &lt;code&gt;No metadata exists inside the DB yet&lt;/code&gt;，是正常的。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;&lt;code&gt;script ...: ...&lt;/code&gt; 開頭的行&lt;/strong&gt; 是腳本用 &lt;code&gt;log()&lt;/code&gt; 寫的，不是錯誤。&lt;/li&gt;&#xA;&lt;li&gt;&lt;strong&gt;所有訊息都在 stderr。&lt;/strong&gt; 管理指令（&lt;code&gt;user&lt;/code&gt;、&lt;code&gt;disconnect&lt;/code&gt;、&lt;code&gt;coa&lt;/code&gt;）的結果在 stdout。&lt;/li&gt;&#xA;&lt;/ul&gt;&#xA;</description>
        </item></channel>
</rss>
