FR-195 Agent 資安修正

掃描在 FR-186（母卡 CM-3675，35 棒全部驗收完）；逐棒報告正本在 Agent repo docs/security-scan/FR-186/scan-*.md。跨 arc 的結論與覆蓋率在 security-scan-consolidated/。

FR-186 把 Agent 整包重掃一次，結果是 1 條高風險、14 條中、15 條低。本案把它們修掉，同一支檔、同一個原因的併成一張卡。

卡上的行號對 Agent 主線 b8b1158（FR-188、FR-190、FR-193 rootless 已合回）核過。1 高與 14 中首腦逐條開檔核過，全部仍然成立。F2～F6 的修法在暫存工作區各試做過一次並跑全量測試，每張卡會讓哪些既有測試變紅、為什麼、怎麼改，都寫在卡上。全量測試基準 2554 passed。

• 卡上不留要人決定的事。工作坊是半夜無人值守跑的；遇到取捨，首腦先查產品裡別處怎麼做、哪個選項不改變既有客戶的用法，自己定案寫進卡。
• 唯一的高風險先修入口：升級驗章「跟著捷徑檔走」這條，先在 Python 端擋掉捷徑檔與清單外的檔（F1），攻擊的入口就封住了。正式出貨的 1.7.4 映像實查過：程式樹 270 個檔、0 個捷徑檔，清單外只有 manifest.json 與 manifest.sig，新規則不會擋到正版升級。
• 主機腳本那一半（F10）範圍已縮小：FR-193 合回後，升級腳本改成「驗過章才存一份主機副本、之後都執行主機副本」。剩下的洞只有一處——驗完把驗過的樹刪掉，存副本時又從映像取第二次；F10 要改成直接用驗過的那份。
• 工具伺服器位址也要在授權清冊內（F3）；本機迴路位址例外，因為那條線出不了這台機器。客戶的 SonarQube／OpenVAS 伺服器要先在主系統登記成設備。
• 改設定要重填密碼只補確定會換連線對象的欄位（F4：SSH／WinRM 連接埠、HTTPS 開關、CA 憑證）；只改帳號名稱不用重填，這是既有的刻意行為，不推翻。
• 連 Windows 主機比照 SSH：第一次連線記住對方憑證指紋（F12）。客戶不用匯入任何憑證，跟遠端桌面第一次連線問要不要信任是同一種做法；Agent 出貨的檢測工具本身支援釘指紋（train-winrm 的 ssl_peer_fingerprint）。沒開 HTTPS 的主機沒有憑證可記，照舊能掃、只多一句提示，預設值不動。
• OpenLDAP 找到多筆同名就拒絕（F13）。改在 jedi-ldap 套件，主系統與 Agent 登入共用；客戶的登入帳號不用變。

批＝工作坊同時開的那一組。同一批的卡不改同一支檔（含測試檔、體積白名單、資安規則檔），腳本比對過同批衝突為 0。

暫緩的 2 張決策者裁示先不做。它們現在沒有東西擋著（原本以為要等的 FR-193 CM-3810、CM-3811 卡上寫明不用做、內容已併入 CM-3809），但卡的內文還是舊的，重開前要對最新的安裝腳本重寫。

可派的 14 張全部跑完，沒有一張卡住或退回。首腦逐張讀 diff，並在三個 repo 合起來的結果上重跑測試。

• Agent（12 張，含兩張補卡）：工作坊 branch ws-CM-3822（9ac649e，已跟上主線 1.7.6）全量 2586 passed、1 skipped、0 failed；守衛 109 passed。53 個檔、+853／-129。沒有動到安裝與升級腳本；體積白名單兩個數字都是往下調。
• 前端（1 張）、jedi-ldap（1 張）：讀過 diff 通過；jedi-ldap 測試 40 passed。
• 已合回主線（2026-11-12，決策者指示先合回一版）：Agent b011adc（合回前主線是 1.7.7）、前端 5e017f1b、jedi-packages ebf43bd3，三個 repo 都已推上遠端。合回後在 Agent 主線上重跑全量 2586 passed、守衛 109 passed；jedi-ldap 40 passed。尚未隨版本出貨給客戶。

驗收時發現兩個副作用，各開一張補卡，兩張都已做完並通過驗收（都是開卡時沒想到的，不是小弟沒照卡做）：

多查、結果沒問題的四件事：升級驗章的新規則不會擋到正版（1.5.6／1.6.0／1.7.2／1.7.4／1.7.5 五個版本的程式樹都是 0 個捷徑檔，並用 1.7.5 正式產物照新規則逐項檢查）；工具位址檢查實測 16 種寫法找不到繞過；PDF 暫存搬到資料目錄下不會讓轉檔壞掉（套件用的是可跨裝置的搬移）；WinRM 給了指紋後自簽憑證照樣能用（讀了出貨工具 chef-winrm 2.5.0 的實作）。

還沒驗到、要真機的三件事：對真的 SonarQube 伺服器跑一次 scan 模式（F6）；原生安裝的機器實際升級一次看資料目錄權限（F8）；對開了 WinRM HTTPS 的 Windows 主機掃一次（F12）。

• F3：SonarQube／ZAP／OpenVAS 的伺服器位址不是本機、也不在主系統設備清冊內的，測試連線與掃描會被擋。
• F4：改工具的連接埠、HTTPS 開關或 CA 憑證時，要把密碼重填一次。
• F6：SonarQube 伺服器位址非本機只收 https。
• F12：開了 WinRM HTTPS 的 Windows 主機，換憑證或重灌後掃描會被拒，要清掉舊指紋。
• F13：OpenLDAP 目錄裡有重名條目的帳號會登入失敗。

• jedi-ldap 0.1.1 發版，Agent 與主系統重裝後 F13 才生效。
• 手冊補四段：工具伺服器要先登記成設備（F3）、改連接埠或 CA 要重填密碼（F4）、SonarQube 只收 https（F6）、Windows 主機換憑證後怎麼清掉舊指紋（F12）。
• F12 對一台開了 WinRM HTTPS 的 Windows 主機實際掃一次，確認指紋被記下。
• F10、F11 先不做（決策者 2026-11-12）。重開前要知道的三件事：F11「儲存密鑰上命令列」不能改用 openssl 從檔案讀金鑰——實測 Ubuntu 22.04／24.04、Debian 12、Rocky 9 的 openssl 都不支援，而且五輪簽章的金鑰都在命令列上；F11「TPM 工具清單沒簽章」實際是容器版交付包首次安裝時整份完整性清單都沒有原廠簽章驗證，屬出版流程的題目，要另開案；F10 在 rootless 之後的風險是映像庫屬 guidant 帳號、升級腳本由 root 執行，驗完到存主機副本之間映像可被換掉。
• ZAP、OpenVAS 目前要客戶自己貼 CA 憑證，這個設計不對（決策者 2026-11-11 指出）；要比照 SSH、LDAP、WinRM 改成第一次連線記住對方指紋。本案不做，另開卡；F9 裡「貼了自訂 CA 只信那一張」那一項因此不修。
• 修完的項目登回跨 arc 總表；FR-186 的逐棒進度表與母卡結案。

每張卡首腦讀 diff＋跑卡上列的測試；合回前在暫存區把最新主線與這批預合跑過全量與守衛，合回後在主線上再跑一次，皆通過。

卡片內容（決策紀錄、驗收條件）以 Notion 為準，本頁只記座標。

相關需求：

• FR-186 — agent-security-rescan
• FR-177 — agent-security-scan
• FR-193 — docker-rootless
• FR-188 — agent-scan-return-and-i18n-fixes
• FR-190 — agent-console-capabilities