GitHub Security

git-secretsとpush protectionの違い

git-secretsは自分のPCのコミットの時点で止めるツール、push protectionはGitHubにpushしたときに止める機能です。止める場所が違います。

先に答え:止める場所の違い

git-secretspush protection
提供元AWS LabsのツールGitHubの機能
止める場所手元のgit hook(commit時・マージ時)GitHubへのpush時
設定の単位リポジトリごとにgit secrets --installユーザー・リポジトリ・organization・enterprise
検出のしかた登録した禁止パターンに一致したら拒否パートナーのパターン・汎用パターン・カスタムパターンなど

git-secretsの使い方(概要)

  1. インストールする(macOSはbrew install git-secrets、Windowsは付属のinstall.ps1)
  2. 使いたいリポジトリでgit secrets --installを実行する(フックは全リポジトリ共通ではないため、リポジトリごとに必要)
  3. git secrets --register-awsでAWSキーのパターンを登録する(--globalで全リポジトリに適用)
  4. git secrets --scanでファイルを、git secrets --scan-historyで履歴全体を調べる

公式は、リポジトリを公開する前に--scan-historyを実行することを勧めています。また、すべての認証情報を検出できる保証はないため、追加の安全策として使う位置づけです。

push 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日。

関連ページ