GitHub Security
git-secretsとpush protectionの違い
git-secretsは自分のPCのコミットの時点で止めるツール、push protectionはGitHubにpushしたときに止める機能です。止める場所が違います。
先に答え:止める場所の違い
| git-secrets | push protection | |
|---|---|---|
| 提供元 | AWS Labsのツール | GitHubの機能 |
| 止める場所 | 手元のgit hook(commit時・マージ時) | GitHubへのpush時 |
| 設定の単位 | リポジトリごとにgit secrets --install | ユーザー・リポジトリ・organization・enterprise |
| 検出のしかた | 登録した禁止パターンに一致したら拒否 | パートナーのパターン・汎用パターン・カスタムパターンなど |
git-secretsの使い方(概要)
- インストールする(macOSは
brew install git-secrets、Windowsは付属のinstall.ps1) - 使いたいリポジトリで
git secrets --installを実行する(フックは全リポジトリ共通ではないため、リポジトリごとに必要) git secrets --register-awsでAWSキーのパターンを登録する(--globalで全リポジトリに適用)git secrets --scanでファイルを、git secrets --scan-historyで履歴全体を調べる
公式は、リポジトリを公開する前に--scan-historyを実行することを勧めています。また、すべての認証情報を検出できる保証はないため、追加の安全策として使う位置づけです。
push protectionの使い方(概要)
- pushにシークレットが含まれていると、GitHubがリポジトリに入る前にブロックし、理由を表示します。取り除いてからpushし直します。
- ユーザー単位のpush protectionは、GitHub.comで既定で有効です。publicリポジトリへのpushが対象です。
- privateリポジトリでリポジトリ単位に使うには、GitHub Secret Protectionが必要です。既定では無効です。
- 書き込み権限があれば、理由を付けてブロックを回避できる設定が既定です。回避するとアラートと監査ログが残ります。
AIにコードを書かせる運用での使い分け
AIが生成したコードに鍵が紛れ込む事故は、コミットの前に止めたいところです。手元で止めたいならgit-secrets、GitHub側の最後の関門としてpush protectionを有効にしておく、と二段にできます。どちらも、鍵が一度でも公開された場合は、取り消して新しい鍵に替えるのが前提です。手順はAPIキーをコミットしたときのページにあります。
FAQ
git-secretsは何を使って止めますか?
git hook(pre-commit・commit-msg・prepare-commit-msg)で、コミットやマージを検査します。
AWSのキー用の設定はどうしますか?
git secrets --register-awsで禁止パターンを登録します。
push protectionのユーザー単位の設定は?
GitHub.comで既定で有効で、publicリポジトリへのpushが対象です。
出典と確認日
確認日:2026年11月12日。