powered by TechFeed
表示モード
ハウツー

AIエージェントがAPIキーをgitにコミットするのを防ぐ4層防御 — Claude Codeを題材に「どの層が何を止められないか」まで解説

11月18日、Nirmataが「How to stop AI coding agents from committing secrets to git」と題した記事を公開した。AIコーディングエージェントがAPIキーや認証情報などのシークレットをgitにコミット・プッシュするのを防ぐための多層防御アプローチについて、Claude Codeを題材に解説している。

11月18日、Nirmataが「How to stop AI coding agents from committing secrets to git」と題した記事を公開した。AIコーディングエージェントがAPIキーや認証情報などのシークレットをgitにコミット・プッシュするのを防ぐための多層防御アプローチについて、Claude Codeを題材に解説している。


GitHubの公式ブログによれば、パブリックリポジトリで検出されるシークレットの件数は年々増加しており、AIコーディングエージェントの普及がその傾向に拍車をかけることが懸念されている。エージェントは.envファイルやハードコードされたAPIキーを「タスクを完遂するための手段」として扱うため、人間の開発者よりも無造作にシークレットをステージ・コミットしやすい側面がある。本記事はClaude Codeを題材に、「単一の防御策では不十分」という前提のもと、4つのレイヤーを組み合わせた実装手順を解説している。

どのレイヤーが何を見ているか

まず、各防御レイヤーの特性を整理する。

レイヤー タイミング 読めるもの エージェントに回避されるか
Claude Code denyルール Bash呼び出し前 Claudeが書いたコマンドテキスト される(別のスペルで回避可)
Claude Code PreToolUseフック Bash呼び出し前 tool_input.commandの全テキスト スクリプト経由なら回避可
git pre-commitフック git commit実行時 ステージ済みの変更内容 --no-verifyで回避可
git pre-pushフック git push実行時 プッシュされるrefとオブジェクト --no-verifyで回避可
GitHub push protection プッシュがGitHubに到達した時 プッシュ内容をシークレットパターンと照合 理由を添えてバイパス可(ログに記録)

GitHubだけが、エージェントが動作するマシンに依存しない唯一のレイヤーだ。 最初の2つはエージェント側で動作し、gitフックは開発者のマシン上で動作する。

Step 1(層1): Claude Codeのsettingsでgit pushをdeny

.claude/settings.jsonにdenyルールを追加し、リポジトリをクローンした全員に適用させる。

{
  "permissions": {
    "deny": [
      "Bash(git push *)"
    ]
  }
}

ただし、このルールには明確な限界がある。 git push origin mainは止められるが、git -C . push origin mainやgit -c push.default=current push origin mainは止められない。Claude Codeの公式ドキュメントも「Bashルールはプログラムを囲むセキュリティ境界ではない」と明記している。次のステップで残りの形式をカバーする。

Step 2(層2): PreToolUseフックでコマンド全文を検査する(最重要)

ここが記事の核心だ。PreToolUseフックはルールが取りこぼす形式を補完できる。特に重要なのが、**--no-verifyフラグの検出**だ。このフラグはgit自身のフック(pre-commit、pre-push)をスキップさせる、いわばすべてのgitフック防御を無効化する「マスターキー」である。

.claude/hooks/check-git-command.shを作成し、実行権限を付与する(chmod +x必須):

#!/usr/bin/env bash
# PreToolUse hook for the Bash tool. Reads the hook JSON on stdin.
cmd=$(jq -r '.tool_input.command // empty')
if printf '%s' "$cmd" | grep -Eq 'git[[:space:]].*(commit|push)' && printf '%s' "$cmd" | grep -q -e '--no-verify'; then
  jq -n '{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason: "git hooks must not be skipped (--no-verify)"}}'
fi
exit 0

記事によると、このスクリプトを実際にサンプル入力で検証した結果:

  • git commit -m fix、git push origin main、ls -la → 何も出力なし(許可)
  • git commit --no-verify -m fix、git -C . push --no-verify origin main → denyを出力

続いて、同じ設定ファイルにフックを登録する:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/check-git-command.sh"
          }
        ]
      }
    ]
  }
}

フックがdenyを返した場合でも、Step 1のdenyルールは引き続き有効だ。ドキュメントには「denyルールにマッチした場合、フックの返値に関わらず呼び出しはブロックされる」と明記されている。

Step 3(層3): git pre-commit/pre-pushフックでステージ内容を検査

Claude Codeのフックは「コマンド文字列」を見るが、「コミット内容そのもの」は見えない。git pre-commitフックはその逆で、ステージされた変更内容を検査できる。これが層3のカバー範囲だ。続くpre-pushフックは層4の手前でプッシュ対象のrefを検査する追加の砦として機能し、本記事では同一Stepで設定する。

チームで共有するために、core.hooksPathでフックディレクトリを指定する:

git config core.hooksPath .githooks

.githooks/pre-commitスクリプト内ではgit diff --cachedでステージ済み変更を検査し、シークレットのパターン(APIキー、トークン等)が含まれていれば非ゼロで終了してコミットを中断する。同様に.githooks/pre-pushではプッシュされるコミット範囲を検査する。元記事には各スクリプトの全文が掲載されているため、実装時は元記事のコードを参照していただきたい。

注意点: スクリプトに実行ビットを設定しないとフックは無言で無視される。git add --chmod=+x .githooks/pre-commitでコミットすること。

Step 4(層4): GitHub push protectionを有効化

push protectionはマシンを離れた後に動作する唯一のチェックだ。リポジトリ、組織、またはエンタープライズレベルで有効化できる。なお、リポジトリ単位ではGitHub Secret Protectionが必要で、デフォルトは無効のため、管理者による明示的な有効化が必要だ。

バイパスされた場合のアラートは以下の通り:

バイパス理由 生成されるアラート
It's used in tests クローズ("used in tests"として解決)
It's a false positive クローズ("false positive"として解決)
I'll fix it later オープンのまま

より厳密な制御が必要な場合、GitHubは「delegated bypass(委任バイパス)」という仕組みを提供している。これは、push protectionのバイパス権限を特定のロール(セキュリティマネージャーや管理者など)に限定し、一般の開発者がバイパスしようとした場合は承認者へのリクエストが必要になる仕組みだ。エージェントが自動的にバイパス理由を付与してすり抜けるリスクを、組織的な承認フローで抑止できる点が重要な意義といえる。

各レイヤーで防げないもの

記事はギャップについても正直に記述している:

  • 別ツール経由のコミット: Claude CodeフックはBashツールしか監視しない。IDEや別のツールからのコミットは見えない。
  • ラップされたコマンド: sh -c 'git push ...'のようにラッパー内に入ったコマンドはBashルールをエスケープする。
  • history内の既存シークレット: push protectionはプッシュされる内容を検査する。push protection有効化前にローカルのhistoryに入ったシークレットは対象外だ。
  • 非対応のシークレット形式: push protectionがカバーするパターン型に該当しない認証情報は通過する。

AIコーディングエージェントへの信頼度が上がるほど、エージェントが実行できる操作の範囲も広がる。シークレット漏洩はその副作用として現実に起きうる問題だ。「denyルール(層1)→ PreToolUseフック(層2)→ git pre-commit/pre-pushフック(層3)→ GitHub push protection(層4)」の4層をすべて有効にして初めて、実用的な防御になる。

詳細はHow to stop AI coding agents from committing secrets to gitを参照していただきたい。