FR-188.SEC-6 資安修正：Agent 檢查更新回傳別家管理員帳號；線上開通一人亂打鎖住全部客戶；DEBUG 開就掛免登入壓測端點（main）

本卡屬 FR-188（母卡 CM-3728），修 FR-187 資安掃描發現的 #246、#250、#262（皆低）。嚴重度：低×3。發現原文、檔名行號、面板票數在 docs/features/FR-187-2611-post-fr172-security-scan/reports/（工作坊工作區 compliance-manager-be/.worktrees/CM-3711/ 裡，主線還沒合；總表 docs/features/security-scan-consolidated/README.md §3.1 同樣在那裡）。Stage 未排，由排批的人決定（見下方「排批注意」）。

問題是什麼（白話）

#246：Agent 按「檢查更新」時，主系統把整台機器共用的「上次檢查結果」原樣回給它，public_check 只用黑名單拿掉 signed_manifest，by（上次是誰按的：總部管理員登入帳號或另一租戶 Agent 的編號）與 agent_base（全機最舊 Agent 版號）照給。

#250：Agent 線上開通入口不用登入、主系統端沒有頻率限制；License Center 依來源位址鎖失敗次數，而所有 Agent 都經主系統同一個出口。持任一租戶任一註冊碼（含用完的）每 15 分鐘送 5 次亂碼，整台主系統所有客戶的線上開通持續回「已鎖定」。

#262：_bench_longpoll.py 這支免登入、會佔住執行緒的壓測假端點，在 DEBUG=true 或 BENCH_LONGPOLL=1 時掛載。出貨 installer 寫 DEBUG=false；2026-11-09 首腦唯讀查 STG 也是 DEBUG=false（小弟回報的「STG 開著」不正確）。風險只在有人為了排錯打開 DEBUG 的時候。

在哪裡

/Users/chouraymond/Projects/Billows/Audit-Manager/compliance-manager-be/app/product_update/service/agent_release_service.py:488  public_check 黑名單
/Users/chouraymond/Projects/Billows/Audit-Manager/compliance-manager-be/api/remote_agent/routes/agent_license_route.py:27-39  免登入開通入口
/Users/chouraymond/Projects/Billows/Audit-Manager/compliance-manager-be/app/remote_agent/service/agent_license_activation_service.py:71-127  驗註冊碼後代打 LC
/Users/chouraymond/Projects/Billows/Audit-Manager/compliance-manager-be/core/plugins/_bench_longpoll.py:17-18  bench_enabled 判 DEBUG
/Users/chouraymond/Projects/Billows/Audit-Manager/compliance-manager-be/main.py:197-199  掛載點

行號以 2026-11-09 主線為準，對不上就以內容為準。

怎麼修

#246 extend：public_check 改白名單，只回 Agent 需要的欄位（狀態、最新版號、大小、sha256、版本說明）。
#250 new（照既有作法）：主系統端加頻率限制——先 grep 既有的限流實作（Redis INCR＋EXPIRE，.claude/rules/security/ai-agent-integration.md「跨行程次數」那條；專案裡登入或 AI 呼叫應該已有一支），reuse 它；按「註冊碼雜湊」與「來源 IP」各計，超過回 429，不轉打 LC。這樣一個人亂打只鎖他自己那把註冊碼。新 error code 照 <前綴>_<HTTP碼><序號>，同步 FE error-code.json（FE 那一半另開卡或併進 FR-188 F-1，回寫說明）。
#262 extend：bench_enabled 只認 BENCH_LONGPOLL=1，不看 DEBUG。

要寫測試

不寫新單元測試（低風險碎片修正）。跑改動模組既有測試。

手測

①Agent 主控台按「檢查更新」，看 Network 回應沒有 by、agent_base；②用一把註冊碼連打開通 10 次亂碼 → 第 N 次起主系統回 429、LC 沒被打（看主系統 log 沒有轉打）；換另一把註冊碼照常能開通；③DEBUG=true 起 8000，GET /api/1.0/_bench/longpoll 回 404；BENCH_LONGPOLL=1 才 200。

排批注意

若改 common/code/error_code.py，與 FR-188 M-1（CM-3735）、M-3（CM-3738） 不能同批（它們也改 error code 登記檔）；建議另開 common/code/agent_license_error_code.py 既有那支加，避開共用檔。

紀律

若新增 error code（#250），改了 common/code/ 登記型共用檔。