Communitygithub.com

Git リーク防止

機密ファイル、シークレット、ビルドアーティファクトがGitHubにプッシュされるのを防ぎます。.gitignoreをスキャン、検出、自動修正します。

Git リーク防止 とは?

このスキルは、Gitリポジトリから機密情報や不要なビルド成果物が誤ってGitHubに公開されるのを防ぐための包括的なセキュリティスキャンと自動修正機能です。.envファイル、node_modules、秘密鍵、証明書、ログファイルなど、一般的な漏洩リスクパターンを検出し、.gitignoreを自動更新して追跡を防止します。また、ハードコードされたシークレット(APIキーやパスワードなど)をコードベース内で検索する機能も備えています。このスキルはWindows環境のPowerShellに対応しており、ripgrep(rg)を使用したシークレット検索、git rm --cachedによる追跡解除、最終的なクリーンなセキュリティレポートの生成までを自動化します。開発者はこれをClaude CodeやCline、CursorなどのAIエージェントプラットフォームで利用でき、プロジェクトのセキュリティ体制を迅速に強化できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add bilals2008/bilal-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Git リーク防止 は何をしますか?

目的

機密ファイル、シークレット、ビルドアーティファクトがGitHubにプッシュされるのを防ぎます。.gitignoreをスキャン、検出、自動修正します。

手順

ステップ 1 — 機密ファイルをスキャン

以下のコマンドを実行して、GitHubに存在すべきでないファイルを見つけます:

git ls-files | findstr /i ".env .env.local .env.production .env.staging node_modules dist build releases *.key *.pem *.p12 secrets"

PowerShellの場合:

git ls-files | Select-String -Pattern "\.env|node_modules|dist|build|releases|\.key$|\.pem$|\.p12$|secrets|\.log$|\.cache$"

また、追跡されていない機密ファイルも確認します:

git status --porcelain

ステップ 2 — 一般的な機密パターンを確認

追跡されているファイル内で以下のパターンを探します:

パターンリスクアクション
.env / .env.*APIキー、DBパスワードGitから削除 + .gitignoreに追加
node_modules/依存関係(巨大、不要)削除 + .gitignore
dist/ / build/コンパイル済み出力削除 + .gitignore
releases/バイナリリリース削除 + .gitignore
*.key / *.pem秘密鍵削除 + .gitignore
*.p12 / *.pfx証明書削除 + .gitignore
.DS_StoremacOSメタデータ.gitignore
Thumbs.dbWindowsメタデータ.gitignore
*.logログファイル.gitignore
.cache/キャッシュフォルダ.gitignore
coverage/テストカバレッジ.gitignore
.turbo/ / .next/ビルドキャッシュ.gitignore
*.sqlデータベースダンプ(機密情報を含む場合あり)内容を確認

ステップ 3 — コード内のシークレットを確認

追跡されているファイル内でハードコードされたシークレットを検索します:

rg -i "(api[_-]?key|secret|password|token|private[_-]?key)\s*[:=]\s*['\x22]" --type-add 'code:*.{ts,tsx,js,jsx,json,yaml,yml,env,config}' -t code

以下のようなパターンを探します:

  • API_KEY=sk-...
  • SECRET=...
  • PASSWORD=...
  • PRIVATE_KEY-----BEGIN
  • token: "eyJ..."

ステップ 4 — .gitignoreを自動修正

機密ファイルが見つかった場合、.gitignoreを自動更新します:

# 現在の .gitignore を確認
cat .gitignore

不足しているエントリを追加します。Webプロジェクトの標準的な.gitignore:

# 環境ファイル
.env
.env.local
.env.production
.env.staging
.env.development

# 依存関係
node_modules/

# ビルド出力
dist/
build/
release/
releases/

# シークレット
*.key
*.pem
*.p12
*.pfx

# IDE
.vscode/settings.json
.idea/

# OS
.DS_Store
Thumbs.db

# ログ
*.log
npm-debug.log*

# キャッシュ
.cache/
.turbo/
.next/
.nuxt/

# カバレッジ
coverage/

# その他
*.swp
*.swo

ステップ 5 — Git追跡から機密ファイルを削除(既に追跡されている場合)

機密ファイルが既に追跡されている場合:

# 追跡から削除(ローカルには残す)
git rm --cached .env
git rm --cached -r node_modules/
git rm --cached -r dist/
git rm --cached -r build/

# その後 .gitignore に追加

警告: シークレットがGitHubにプッシュされた場合、それらは危険にさらされています。ユーザーは以下を実行する必要があります:

  1. 公開されたすべてのキー/シークレットを直ちにローテーションする
  2. 同じシークレットを二度と使用しない

ステップ 6 — ユーザーにレポートを表示

調査結果を明確に提示します:

🔍 セキュリティスキャンレポート

リスクのあるファイル:
  ❌ .env — 追跡されています(シークレットを含む)
  ❌ node_modules/ — 追跡されています(無視されるべき)
  ⚠️ dist/ — 追跡されています(ビルド出力)

実行したアクション:
  ✅ .env を .gitignore に追加
  ✅ node_modules/ を .gitignore に追加
  ✅ dist/ を .gitignore に追加
  ✅ .env を Git追跡から削除(ローカルに保持)

⚠️ .env に実際のシークレットが含まれていた場合、今すぐローテーションしてください。
   GitHubの履歴には古いバージョンが残っています。

ステップ 7 — 修正をコミット

git add .gitignore
git commit -m "chore(security): update gitignore to prevent secret leaks"

やってはいけないこと

  • ❌ レポートに実際のシークレット値を表示しないでください(マスクすること: sk-****...****)
  • ❌ たとえ「一時的」な理由でも .env やシークレットをコミットしないでください
  • ❌ シークレットがすでにプッシュされている場合の警告を無視しないでください
  • ❌ git ls-files の確認をスキップしないでください — 追跡されていないファイルは問題ありませんが、追跡されているファイルがリスクです

期待される出力

クリーンなセキュリティレポートを表示:

  1. 何がリスクとして見つかったか
  2. 何が自動的に修正されたか
  3. ユーザーが手動で行う必要があること(キーのローテーション)

関連スキル