Agent 主控台權限能力點化

Agent 主控台的權限由主系統決定：使用者點「進入主控台」時主系統逐顆查他持有的 Agent 能力點，把對應範圍寫進五分鐘票；斷線用的離線操作者名單也是每次心跳依當下能力點重算下發。這套機制正確，但只有 7 個範圍：configure 包 9 個設定頁、download-files 包 5 種下載、看與執行不分、主系統派的掃描紀錄掛在 configure。管理員做不到「可下載報告但不可下載證據」「只管 LDAP 不碰帳密」。

本案把 7 個範圔拆成 11 個主控台功能 × 檢視／設定／執行／下載＝26 顆，全部進主系統能力點表，角色頁以「Agent 管理 › Agent 主控台」子頁分組逐顆給；三邊（主系統、jedi-remote-agent、evidence-agent）改讀 jedi-agent-protocol 同一份清單。

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E2F0F1','primaryTextColor':'#14201F','primaryBorderColor':'#0E7C86','secondaryColor':'#EEF2F3','secondaryTextColor':'#14201F','tertiaryColor':'#FBFCFC','tertiaryTextColor':'#14201F','lineColor':'#4A5A5C','textColor':'#14201F','mainBkg':'#E2F0F1','nodeBorder':'#0E7C86','nodeTextColor':'#14201F','edgeLabelBackground':'#FBFCFC','titleColor':'#14201F','clusterBkg':'#FBFCFC','clusterBorder':'#E4EAEB','actorBkg':'#E2F0F1','actorTextColor':'#14201F','actorBorder':'#0E7C86','actorLineColor':'#C7D1D2','signalColor':'#4A5A5C','signalTextColor':'#14201F','labelBoxBkgColor':'#EEF2F3','labelBoxBorderColor':'#C7D1D2','labelTextColor':'#14201F','loopTextColor':'#14201F','noteBkgColor':'#F6EBD5','noteTextColor':'#14201F','noteBorderColor':'#9C6B12','activationBkgColor':'#EEF2F3','activationBorderColor':'#C7D1D2','sequenceNumberColor':'#FFFFFF'}}}%%
sequenceDiagram
    participant Admin as 管理員
    participant Main as 主系統
    participant Agent as Agent
    participant User as 使用者
    Admin->>Main: 角色頁「Agent 主控台」子頁勾顆（或按「比照帶入」）
    User->>Main: 點「進入主控台」
    Main->>Main: capability_checker 逐顆查 26 顆 → 持有的寫進票 scope
    User->>Agent: 帶票登入
    Agent->>Agent: 不認得的範圍丟掉並記數；全丟才拒
    Agent-->>User: 側欄依 *.read 出現；按鈕依 update／execute／download
    Main->>Agent: 每次心跳：離線名單帶該使用者當下 24 顆內持有的

整案一句話：7 個範圍拆成 26 顆，三邊改讀同一份清單，角色頁逐顆給，同步機制不動。

依賴：批 1 的環境卡是硬前置——主系統釘 jedi-remote-agent==1.17.6、Agent 釘 jedi-agent-protocol==0.5.3，不改走本機路徑，批 2 的卡 import 到的是舊發行版、測試假綠。

測試前提：26 顆新權限的守門在新版 Agent 裡，驗收用的 Agent 必須先裝到 P1-4／P1-5 的版本。

5.1 26 顆清單（protocol console_scopes.py 的內容）

能力點全名 agent.<資源>.<動作>（模組是 agent，不是 detection）；票上與 Agent 守門用 <資源>.<動作>。license_module 一律 remote-agent-manage（授權照模組鍵不變）、home_route 一律 remote-agent-console。

共 26 顆（4＋4＋4＋2＋2＋2＋2＋2＋4＋2＋2）。OFFLINE_GRANTABLE 24 顆。

MIRRORS（D9 帶入對照，主系統能力點 → Agent 顆）：detection.plugin.update → tools.update、detection.plugin.read → tools.read、detection.profile.read → scan.read、detection.profile.update → scan.execute、system.ldap-config.read → ldap.read、system.ldap-config.update → ldap.update、platform.license.read → license.read、platform.license.update → license.update、system.storage-config.read → ops.read、system.storage-config.update → ops.update、system.product-update.read → update.read、system.product-update.update → update.execute、detection.remote-agent.update → keys.update, ops.execute、detection.remote-agent.create → setup.update、grc.job-evidence.download → files.download。無對照：logs.*、netdiag.*、各顆 read 以外沒列到的。

為什麼放 protocol 不放 jedi-remote-agent：Agent 不裝 jedi-remote-agent（帶 Flask／jedi-common），只裝 protocol；三邊都 import 得到的只有這裡。

5.2 舊顆 → 新顆展開（D5，P1-2 migration）

展開走 role_capabilities 與 role_capability_patterns 兩條路（照 FR-166 migration 第 3 段形狀）。刪舊顆前先 DELETE 三張關聯表（role_capabilities、route_capabilities、role_capability_patterns 字面 pattern）的對應列——這三張表對 capabilities 無外鍵，不清會留孤兒。Administrator 靠 *.*.* 自然持有，不另處理。出貨預帶照 §5.1「離線可下放」旁的角色欄不在本案 migration 內（角色範本在 _capability_grants.sql 模板，P1-2 一併補 IT Manager／稽核員兩列）。

5.3 Agent 守門對照（P1-5）

5.4 主控台 FE 對照（P1-6）

router.js：scan→scan.read；netdiag→netdiag.read；runs→['scan.read','netdiag.read']；logs→logs.read；tools→tools.read；ldap→ldap.read；files→files.read；ops→ops.read；keys→keys.read；license→null（不變）；update→update.read；setup→setup.update。各 view 的操作鈕：canDownload 看各自 *.download；canConfigure 看各自 *.update；掃描／除錯「執行」鈕看 *.execute；Ops.vue 重啟鈕看 ops.execute。Shell.vue：me.dropped_scopes > 0 顯示 .hint 橫幅，文案進 agent-console.json。

5.5 主站 FE 對照（P1-7）

Agent 管理頁按鈕 v-can：「進入主控台」→26 顆任一（reuse useMenuItemsCan 的 ANY）；「重啟」→ops.execute；「換發憑證」→keys.update；「補更新基準」→ops.update；執行紀錄頁下載→scan.download／netdiag.download 依列種類。

5.6 主系統端點對照（D7，P1-3）

5.7 Agent 驗票（D2，P1-4）

verify_console_ticket 回 (claims, dropped: list[str])：scope 過濾成 [s for s in scope if s in CONSOLE_SCOPES]，空 → 403 TICKET_SCOPE_EMPTY（新錯誤碼進 protocol error_codes）；TicketScopeUnknown 類別與路徑移除。ConsoleSession.dropped_scopes: int，不落地（_PERSISTED 不含）。/api/me 多 dropped_scopes。離線名單 offline_operators.py 第 85 行的過濾改讀新清單，行為不變。舊 7 個名字一律不認（不做舊主系統相容）。

5.8 資安規範對照

• SR-02（授權）：守門只收緊不放寬——26 顆對 7 顆是細分，任一端點的新顆集合 ⊆ 舊顆持有者集合（§5.3 表逐列可驗）；守衛測試 test_fr190_scope_table.py 對每顆單一 session 逐支打。
• SR-01（身分）：D2 丟掉不認得的範圔只縮不放；全丟拒絕用既有同一回應形狀。
• 票不帶訊息、不加心跳鍵（FR-181）：本案不動心跳與事件契約，protocol 只加 console_scopes 模組與一個錯誤碼。

由 handoff/cards.py 產；批＝可同時派的一組，階段只是分組。python handoff/cards.py 驗依賴在更早批、同批不撞檔。

登記型檔 owner：protocol console_scopes.py→P0-1；remote-agent contract.py→P1-1；BE _ADMIN_CAPABILITIES→P1-3；BE manifest.tsv→P1-2；Agent constants.py＋agent_auth.py→P1-4；Agent console/api/*.py→P1-5（一張卡全換，拆開會撞 __init__.py）；FE console router.js→P1-6；FE 主站三支 i18n／capabilities.js→P1-7；FE api.js→P2-2。