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_Store | macOSメタデータ | .gitignore |
Thumbs.db | Windowsメタデータ | .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-----BEGINtoken: "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にプッシュされた場合、それらは危険にさらされています。ユーザーは以下を実行する必要があります:
- 公開されたすべてのキー/シークレットを直ちにローテーションする
- 同じシークレットを二度と使用しない
ステップ 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の確認をスキップしないでください — 追跡されていないファイルは問題ありませんが、追跡されているファイルがリスクです
期待される出力
クリーンなセキュリティレポートを表示:
- 何がリスクとして見つかったか
- 何が自動的に修正されたか
- ユーザーが手動で行う必要があること(キーのローテーション)