為 AI Agent 放行 git,也會一併放行 diff.external 和 core.fsmonitor
Allowlisting git for Your Agent Also Allowlists diff.external and core.fsmonitor
為 AI Agent 放行 git 命令,也可能讓 diff.external、core.fsmonitor 等 Git 設定觸發外部程序,令看似唯讀的 git diff 或 git status 執行程式。
文章説明 Git 設定如何令白名單放行的命令執行外部程序,並提供跨 worktree 檢查設定來源的方法,方便排查 Agent 工作區的風險。
- 書籍: 大型語言模型應用程式的可觀測性
- 我還有以下著作: 以 Go 思考(兩冊系列)— Go 程式設計完整指南 + Go 中的六角形架構
- 我的專案: Hermes IDE | GitHub — 為使用 Claude Code 及其他 AI 程式開發工具交付產品的開發者而設的 IDE
- 我: xgabriel.com | GitHub
你告訴你的 Agent,它可以不經詢問便執行git。當時感覺很安全:你希望git status和git diff不要再打斷你。以下是一條同樣以git開頭的指令:
git -c diff.external='sh -c "cat .env"' \
diff --no-index /dev/null .env
這就是 HiddenLayer 在2026 年 10 月 22 日有關遭入侵 LLM 閘道的研究中展示的偽造工具呼叫。該研究指出:「由於指令以已核准的 git 前綴開頭,Codex 會直接執行,不會提示用戶。」Git 將差異內容交給外部程式,該程式是cat .env,機密資料再透過對話紀錄傳回。Agent 從未要求讀取.env。閘道代它編寫了該工具呼叫。
在 git 方面,大量設定鍵會指定要執行的程式,而 git 會在你以為是唯讀的指令執行期間啟動這些程式。
HiddenLayer 展示的內容
整個架構是在 Agent 與模型之間放置一個閘道,類似LiteLLM代理伺服器。閘道會轉送請求和回應,因此遭入侵的閘道可以在模型的回覆中加入工具呼叫。Agent 看到看似正常的回覆後便會執行它。HiddenLayer 的論文探討 Codex 的權限指示,其中列出用戶已核准的指令前綴。git在清單中時,上述指令毋須提示即可執行。論文亦指出,Codex 的權限設定檔會將儲存庫的.git目錄標示為可寫入。
搜尋相關資料前,先説明一個名稱上的區別:HiddenLayer 的另一個示範使用了 Hermes Agent,那是 Nous Research 的 Agent。它與我開發的 Hermes IDE 毫無關係。
這不是diff.external首次將 Agent 的 git 允許清單變成程式碼執行漏洞。在Pillar Security 的 GitPwned 分析文章中,該漏洞於 2026 年 7 月 20 日公開;Codex CLI 將git show視為安全項目。git show --output=./.git/config在儲存庫設定中加入了[diff] external = ...區段,而下一個同樣列於安全清單的git diff便執行了它。OpenAI 在 Codex CLI v0.95.0 中修復了這個問題。加強防護的 PR於 2026 年 2 月 2 日合併,現在將--output及「可能觸發外部執行的風險 Git 設定覆寫旗標(-c, --config-env)」列為需要核准的項目。
這項修復涵蓋 Codex 內置的安全指令清單。你自行核准的前綴則是另一回事:它允許前綴之後接上任何內容。
用 echo 重現
使用一次性儲存庫。以下操作都不會影響資料夾以外的任何內容。
git init -q gitcfg-demo && cd gitcfg-demo
echo 'GREETING=hello' > .env
git -c diff.external='sh -c "echo diff.external ran"' \
diff --no-index /dev/null .env
git 不會產生差異內容,而是執行sh -c字串,因此你應該會看到diff.external ran這一行。Git 會以七個引數呼叫外部 diff 程式(路徑、舊檔案、舊雜湊值、舊模式、新檔案、新雜湊值、新模式)。sh -c會從$0開始將它們依序接收為引數,並忽略它們,所以這個單行指令才能運作。
現在來看完全不需要-c的版本。這與Sonar 在 2022 年有關 git 整合的研究中的酬載相似:
git config core.fsmonitor 'echo fsmonitor ran > proof.txt'
git status
cat proof.txt
git config --unset core.fsmonitor
rm proof.txt
git status會從.git/config讀取core.fsmonitor,並將其作為檔案系統監視器掛鈎執行。Sonar 列出git status和git diff,指它們是會觸發該掛鈎的指令。一旦該行寫入儲存庫設定,連最像唯讀操作的指令也會執行程式。
最後看一個別名:
git config alias.st '!echo alias ran'
git st
git config --unset alias.st
git-config 文件指出,以 ! 開頭的別名「會被視為 shell 指令。」
會執行程式的設定鍵
摘錄自 git-config 參考手冊 (2.56.0)、git-diff、githooks 及 Sonar 的説明文章:
| 設定鍵 | Git 執行的內容 | 時機 |
|---|---|---|
diff.external |
你指定的 diff 指令 | git diff |
diff.<driver>.textconv |
某種檔案類型的轉換器 |
git diff, git log
|
core.fsmonitor |
fsmonitor 鈎子 |
git status, git diff
|
core.pager |
透過 shell 執行的分頁器 | 輸出至終端機 |
core.sshCommand |
ssh 的替代品
|
git fetch, git push
|
core.hooksPath |
來自另一個資料夾的 Hook |
git commit 及其他項目 |
core.editor |
你的編輯器 |
git commit、git tag
|
alias.<name> = !...
|
一條 shell 命令 | git <name> |
有兩點要注意。Git 只有在「標準輸出是終端機」時才會啟動分頁器(Git 文件),因此 core.pager 是否觸發,取決於你的 Agent 如何執行命令。而 textconv 驅動程式的名稱寫在 .gitattributes 中,該檔案會提交至儲存庫,但命令本身必須來自設定。
Sonar 指出,複製儲存庫並不會一併帶走其中的 .git/config,因此設定有三種方式可以傳入 Agent:
- 在命令列上使用
-c或--config-env。這是 HiddenLayer 採用的方式,而任何提示詞注入都可以要求使用這種方式。 - 由具備
.git寫入權限的項目寫入.git/config:Agent 的檔案工具,或使用--output的 Git 命令,例如 GitPwned。 - 在 Git 外部取得的資料夾中,例如封存檔或下載檔,並且包含其中的
.git/。
如果你在 worktree 中執行 Agent,方式 2 有個特殊之處。git-worktree 文件指出:「預設情況下,儲存庫的 config 檔案會由所有 worktree 共用。」一個 Agent 只要寫入一次 core.fsmonitor,該儲存庫的每個 worktree 都會在下次 git status 時執行它。
針對各 Agent 的更嚴格規則
允許子命令,切勿只允許主程式。然後禁止設定覆寫旗標。
Codex 規則會將引數清單視為「完全相符的前綴」;若有多條規則相符,優先次序為「禁止 > 提示 > 允許」。開啟 ~/.codex/rules/default.rules(TUI 會在此儲存你的核準設定),刪除任何模式只有 ["git"] 的規則。然後加入:
prefix_rule(
pattern = ["git", "-c"],
decision = "forbidden",
justification = "config overrides can run programs",
match = ["git -c diff.external=x diff"],
not_match = ["git status"],
)
對於規則涵蓋的命令,禁止規則優先於任何允許規則。但完全相符的前綴只會檢查開首的引數。它無法捕捉兩種形式的 --config-env,也無法捕捉放在其他全域選項之後的 -c,例如 git -C . -c diff.external=x diff,因為此時第二個引數並不是 -c。如果存在範圍寬泛的 ["git"] 允許規則,這些命令就會執行。這正是為何一開始就不應只允許 git。
在 Claude Code 中,不要加入 Bash(git *)。其文件列出了這個確切的陷阱:Bash(git * main) 會匹配 git -c core.fsmonitor=<script> diff main。git 的唯讀形式本來就會在沒有提示的情況下執行。請為覆寫旗標加入拒絕規則:
{
"permissions": {
"deny": ["Bash(git -c *)", "Bash(git --config-env*)"]
}
}
和任何 Bash 規則一樣,這些規則會匹配命令文字,因此 git -C . -c ... 可以避過它們。文件中的表格就展示了 git -C . push origin main 如何繞過 Bash(git push *)。同一頁亦指出,Bash 規則「並非用來限制程式的安全邊界」:它也無法阻止 sh -c 'git ...'。Claude Code 會將 .git 視為受保護路徑,而其文件警告,bypassPermissions 模式即使要在該處寫入,也會略過提示。
你也可以在 Agent 的環境中固定最重要的設定鍵。GIT_CONFIG_COUNT 變數屬於「command」範圍;Git 會在讀取儲存庫本身的檔案後讀取這些變數,而「最後找到的值」會生效:
export GIT_CONFIG_COUNT=2
export GIT_CONFIG_KEY_0=core.fsmonitor
export GIT_CONFIG_VALUE_0=false
export GIT_CONFIG_KEY_1=diff.external
export GIT_CONFIG_VALUE_1=
export GIT_PAGER=cat
這些固定設定可以蓋過遭篡改的 .git/config(方式 2 和 3)。但命令列設定的優先次序更高:git-config 文件指出,這些變數「會被透過 git -c 傳入的任何明確選項覆寫」。因此,它們無法阻止 HiddenLayer 採用的命令列方式;這需要依靠上面的規則。
Pillar 的文章使用同一個空白的 diff.external= 覆寫來中斷這條鏈。GIT_PAGER=cat 可阻止 git 啟動分頁器,git 文件亦有説明。Git 2.35.1 及較舊版本會把 false 解讀為 hook 路徑,而非布林值,因此請先更新 git。再加入一組 core.hooksPath=/dev/null 也會停用 hooks,但文件指出「通常只建議專家用戶按個別命令使用」,因此只有在你的儲存庫沒有你需要依賴的 hooks 時才加入。以上做法都不涵蓋 diff.<driver> 或 alias 項目,因此你仍然需要進行審核。
審核每個工作樹
--show-scope 和 --show-origin 會指出每個值的來源:system、global、local、worktree 或 command,以及設定該值的檔案。請使用 git config 執行,而非 git status,因為 status 是會執行 core.fsmonitor 的命令之一:
pat='fsmonitor|pager|sshcommand|hookspath|editor'
pat="$pat|external|\.command=|textconv|alias\.|filter\."
git worktree list --porcelain | sed -n 's/^worktree //p' |
while IFS= read -r wt; do
echo "== $wt"
git -C "$wt" config --show-scope --show-origin -l |
grep -iE "$pat"
done
local 或 worktree 中任何不是你自行加入的項目,都要仔細查看。在你自己的 ~/.gitconfig 中出現 core.pager 屬正常情況。但在 Agent 工作階段期間出現在 .git/config 中的 core.fsmonitor,則不正常。
我是 Hermes IDE 的開發者,因此閲讀這段內容時請把這點納入考量。Hermes 會為每項任務建立獨立的 hermes/<name> 分支和 worktree;這正是同一儲存庫中一個遭污染的 .git/config 會影響每項任務的情況。它的 Review Desk 會逐回合比較你的檔案差異。.git/config 並非受追蹤的檔案,因此不要指望任何差異檢視畫面(包括 Review Desk)會向你顯示它。在完成任務前,請執行上述循環。Hermes 不會代你回應權限提示,因此上述規則仍由 Agent 自行遵守。它在 macOS、Windows 和 Linux 上免費提供,並開放原始碼供查閲(BSL 1.1):下載或閲讀原始碼。

Review Desk 的 Worktrees 分頁:在 ~/code 下,orders-api、web-app 和 orders-types 各有一個 Hermes 工作樹;每個工作樹均列出其 hermes/ 分支、任務、存續時間和磁碟大小。
允許清單會檢查命令文字。Git 會根據允許清單看不到的設定狀態決定執行甚麼,因此請在你目前開啟的儲存庫中執行整套檢查流程。
如果這些內容對你有幫助
HiddenLayer 的攻擊發生在閘道中;許多團隊早已透過這個設備轉送 LLM 流量,因此閘道本身的記錄並不是尋找該攻擊的正確位置。如果你在 Agent 一側追蹤 Agent 實際執行的工具呼叫,git -c diff.external=... span 就是可以設定警示的項目,而不必事後才在對話記錄中發現。LLM 應用程式的可觀測性是我撰寫的一本書,探討正式環境中 LLM 功能(包括閘道)的追蹤、評估和成本。
來源:DEV Community · dev.to

