CI/CDやGitHubで秘密情報が漏れる仕組み
そして、その止め方
.env ファイルのコミット、プルリクエストへのトークンの貼り付け、CI ログへのシークレットの出力はやめましょう。GitHub やパイプラインにおいて、どこから認証情報が漏洩するのか、そして使い捨ての暗号化リンクがどのように安全な開発ワークフローに適合するかを学びます。

要点
- Never commit `.env` files or cloud keys to Git.
- Assume leaked history is public until rotated and purged carefully.
- Use the platform secret store for CI/CD—not chat pastebins.
- Scan early and rotate immediately when a leak is found.
API キーが巧妙な暗号攻撃によって漏洩することは通常ありません。それらは開発者のワークフロー、つまり Git にチェックインされた `.env` ファイル、CI ログにエコーされた機密情報、そして「とりあえず」としてプルリクエストに貼り付けられた認証情報を通じて漏洩するのです。
もしあなたがすでに API キーを安全に共有する方法を知っているなら、このガイドはその次のステップです。現代のソフトウェアデリバリーにおいて、それらのキーが実際にどこから流出するのか、そして GitHub、CI/CD、およびローカル設定が本番環境へのアクセスの永久的なアーカイブにならないようにする方法を解説します。
パターンは常に同じです。機密情報が履歴を保持するために構築されたシステムに入り込みます。数ヶ月後、フォーク、ログのエクスポート、侵害されたノートPC、あるいは公開リポジトリのスキャンによって、その利便性がインシデントへと変わるのです。
なぜ .env ファイルと CI/CD が開発者の漏洩マグネットになるのか
ローカル環境ファイルとパイプラインは、設定を迅速に移動するために存在します。そのスピードは有用ですが、危険でもあります。なぜなら、機密情報は、コードレビュー、ビルドアーティファクト、自動化に使用するのと同じツールと共に移動することが多いからです。
`.env` ファイルは一時的なものだと感じられます。CI に保存された機密情報は「処理済み」であると感じられます。プライベートリポジトリ内のデバッグ用の `echo $DATABASE_URL` は無害に感じられます。しかし、攻撃者や自動化された機密情報スキャナーは、その露出が意図的であったかどうかを気にしません。彼らが気にするのは、永続性、検索可能性、および影響範囲(ブラスト半径)です。
Git や CI に触れるすべての機密情報は、最終的にコピー、ミラーリング、またはインデックス化されるものとして扱ってください。その前提があっても耐えられるようなワークフローを設計してください。つまり、短命な認証情報、適切なシークレットストア、そしてチャットやチケットに平文を残さない人間による受け渡しです。
GitHub を通じて機密情報が流出する仕組み
コミットされた .env および設定ファイル
最も一般的なのは、依然として古典的な漏洩です:`cp .env.example .env`に本番環境の値を入力し、気づかないうちに`git add .`してしまいます。たとえ次のコミットでファイルを削除したとしても、履歴を書き換えない限り、シークレットはGitの履歴に残ります。また、公開リポジトリは非常に迅速に露出した認証情報のスキャンを受ける可能性があります。履歴の書き換えを行っても、すべてのコピーが消去されるわけではありません。フォーク、ミラー、CIキャッシュ、ローカルクローンには、古いコミットが残っている可能性があります。
バリエーションには、パスワードをハードコードした`docker-compose.yml`、機密性の高い出力を含むTerraform state、base64エンコードされた「シークレット」を保存するKubernetesマニフェスト(base64はエンコードであり、暗号化ではありません。マニフェストを読める人なら誰でも値をデコードできます)、およびトークンをプリントするノートブックのセルなどがあります。設定ファイルのように見えるものは、スキャナーによって認証情報のダンプとして扱われると想定してください。
プルリクエスト、Issue、およびコメント
開発者が「レビュアーがバグを再現しやすくするため」に、ステージング用のキーをPRの説明に貼り付けてしまうことがあります。チケットのコメントやGitHub Discussionsも同様の問題を抱えています。検索可能な永続性、通知、メールダイジェスト、およびエクスポートがその要因です。
プライベートリポジトリは偶発的な露出を大幅に減少させますが、それでも適切なシークレットストアではありません。アクセス権の変更、契約社員、侵害されたアカウント、クローン、バックアップ、および統合によって、過去のプレーンテキストが再浮上する可能性があります。人間同士でAPIキーを受け渡す場合は、PRのコメントではなく、クライアントサイドで暗号化されたワンタイムリンクを使用してください。
フォーク、ミラー、そして決して消えない履歴
一度コミットされたキーは、メインブランチがクリーンアップされた後も、フォーク、ミラー、CIキャッシュ、およびローカルクローンの中に生き残り続けることがあります。真の救済策はシークレットのローテーションであり、履歴の書き換えはあくまで被害を抑えるための処置です。
GitHub Secret Scanning、TruffleHog、gitleaks、またはクラウドプロバイダーのアラートが作動した場合は、まずローテーションを行ってください。その後、アクティブなブランチからシークレットを削除します。履歴の書き換えを行うべきかどうかは、その調整コストに見合うかどうかを判断してから決めてください。
鉄則
本番用のシークレットをGitにコミットしないでください。たとえ一時的なステージング用の認証情報であっても同様です。シークレットを人の間で移動させる必要がある場合は、クライアントサイドで暗号化されたワンタイムリンクなど、適切な安全な配信チャネルを使用してください。自動化プロセスにシークレットが必要な場合は、CIプラットフォーム独自のシークレットメカニズム、専用のシークレットマネージャー、または(リポジトリではなく)ワークロードアイデンティティやOIDCを通じて取得した短寿命の認証情報を使用してください。
CI/CDを通じてシークレットが漏洩する仕組み
ワークフローファイル内のプレーンテキスト
`API_KEY: sk-...`を`.github/workflows/*.yml`、GitLab CI YAML、またはCircleCIの設定に直接記述することは、余計な手間をかけてシークレットをコミットしているのと変わりません。ワークフローファイルはコードです。それらはレビューされ、クローンされ、永久に保持されます。
プラットフォーム独自のシークレットメカニズム(GitHub Actions secrets、GitLab CI/CD variables、および同等のもの)を使用し、ハードコードされたYAMLではなく、環境バインディングとして参照してください。ネイティブのCIシークレットはリポジトリに保存するよりはるかに優れていますが、魔法ではありません。悪意のあるワークフローロジック、侵害された依存関係、不注意なロギングによって、実行時に値が露出する可能性があります。CIに長寿命のクラウドキーを一切必要としないよう、クラウドプロバイダーへのOIDCまたはその他のワークロードアイデンティティ連携を優先してください。
パイプラインログとデバッグ出力
ビルドログは過小評価されがちなアーカイブです。「デプロイをデバッグするため」に環境変数をプリントしたり、`process.env`をダンプしたり、詳細なTerraform/Helmの出力を実行したりすると、ジョブの終了後も残るログストレージに認証情報が書き込まれる可能性があります。
ログはCIへのアクセス権を持つ全員、そして時にはアーティファクトをダウンロードできる全員が読めるものだと想定してください。シークレットをマスクし、環境変数のダンプを避け、漏洩したログ行を漏洩したパスワードと同様に扱い、ローテーションを行ってください。
フォークからのプルリクエスト
フォークからのPRは、信頼できないコードがシークレットを使用して実行されるという、古典的なCIの罠です。ほとんどのプラットフォームは、まさにこの理由から、フォークされたワークフローでのシークレットの利用を制限しています。その設定を維持してください。外部のコントリビューターのチェックをパスさせるために、安易に「シークレットを有効にする」ことは決してしないでください。
内部リポジトリであっても、権限を持つデプロイジョブとPRチェックは分離したままにしてください。最小権限でビルドとテストを行い、明示的にシークレットが許可された信頼できるブランチからのみデプロイを行ってください。
共有ランナーとアーティファクトの漏洩
セルフホストランナー、共有キャッシュ、およびアップロードされたアーティファクトは、それらを作成したジョブよりも長くトークンを保持する可能性があります。ワークスペースをクリーンアップし、キャッシュキーの範囲を慎重に設定し、「利便性のため」に`.env`ファイルをビルドアーティファクトにパッケージ化しないでください。
より安全なメンタルモデル:シークレットが存在しうる3つの場所
チームがあらゆる作業に一つのツールを使用しているときに混乱が生じます。ライフサイクルによって問題を切り分けましょう。
| 場所 | 向いている用途 | 用途 |
|---|---|---|
| ローカル .env / dotenv | ノートPC内に留まり、適切にgitignoredされているローカル開発用の設定 | チームメイト、CI、Git、または長期間有効な本番用シークレットをプレーンテキストで共有すること |
| CIネイティブのシークレット / Vault / クラウドシークレットマネージャー | マシン間(M2M)のランタイムおよびデプロイ自動化 | チャットでの手渡しや、「これを業者に渡しておいて」といった長期間有効なメッセージ |
| クライアントサイド暗号化された使い捨てノート | キー、トークン、または .env スニペットの人間同士の受け渡し | アプリやパイプラインの本番用シークレットの保存 |
ローカル開発においては、gitignored された `.env` で問題ありません。機密性の高い本番用シークレットについても、開発者のマシン上にプレーンテキストのまま永続的に置かないのが理想的です。可能な限り、パスワードマネージャーや短期間有効なアクセス権を利用してください。PrivateNote は3番目の役割を担います。つまり、人間同士の安全な受け渡しです。これは GitHub Actions シークレット、HashiCorp Vault、AWS Secrets Manager、またはパスワードマネージャーの代わりになるものではありません。日常的な API キーの受け渡しには、本サービスと API キーを安全に共有する方法 を組み合わせて使用してください。
実践的なワークフロー:Gitやチャットからシークレットを排除する
チームメイト、業者、またはクライアントが、最終的にCIやローカルの `.env` に格納される値を必要とする場合は、以下の手順を使用してください:
- 1
ステップ 1
スコープを限定した短期間有効な認証情報を作成する
ステージング用のキー、読み取り専用スコープ、IP許可リスト、および有効期限の設定を推奨します。「速いから」という理由で本番用のプライマリキーを渡すことは避けてください。
- 2
ステップ 2
クライアントサイド暗号化された使い捨てノートで届ける
シークレット(または必要な数行の `.env`)を、PrivateNote を使用してローカルで暗号化します。方法は Webアプリ、CLI、VS Code / Cursor 拡張機能、または Chrome 拡張機能 です。短い有効期限または「開封後に破棄(burn-after-read)」を設定し、プレーンテキストではなくノートのリンクを Slack、メール、またはチケット経由で送信してください。
- 3
ステップ 3
適切なストアにインストールする
受信者は、その値を gitignored されたローカルの `.env`(開発用)、パスワードマネージャー、またはCI/クラウドのシークレットストアにコピーします。PR、チャットスレッド、または共有ドキュメントに貼り付け直さないでください。
- 4
ステップ 4
作業完了後にローテーションする
業者のキーを失効させ、インシデント発生後にローテーションを行い、ログ、Git、またはチケットに一度でも表示された認証情報はすべて交換してください。ローテーションを伴わない利便性は、単に侵害への対応を遅らせているだけです。
今すぐ誰かにCIトークンや数行の .env を渡す必要がありますか? プレーンテキストをコミットしたり貼り付けたりする代わりに、クライアントサイド暗号化された使い捨てノートを送信してください。
プライベートメモを作成普段の作業環境から共有する
クライアントサイド暗号化された使い捨てノートを作成するために、ターミナル、エディタ、またはブラウザのタブを離れる必要はありません。その場に最適な PrivateNote を選択してください。暗号化は常にアップロード前にデバイス上でローカルに行われます。詳細なガイドについては、開発者向け PrivateNote を参照してください。
CLI
ファイルまたは標準入力(stdin)から読み取ることで、シークレットが `echo` 引数としてシェル履歴に残るのを防げます:`npx privatenote-cli --expire 1h --output-url-only .env.local` または `cat secret.txt | npx privatenote-cli --expire 1h --output-url-only`。シェルのワークフロー、スクリプト、およびターミナルでの素早い受け渡しに便利です。セットアップとフラグについてはこちら:PrivateNote CLI。
VS Code と Cursor
VS Code / Cursor 拡張機能 をインストールし、サイドバー、エディタの選択範囲、またはコンテキストメニューから暗号化します。これは、シークレットがすでに `.env` や設定ファイル上に表示されており、Slack にプレーンテキストとして渡したくない場合に最適です。
Chrome拡張機能
メール、ドキュメント、またはチケットに認証情報が表示された際、Chrome extension を使用すると、タブを離れることなく、選択したテキストをブラウザで暗号化されたワンタイムノートに変換できます。
プッシュおよびパイプライン変更前のデベロッパー用チェックリスト
| チェックポイント | 確認事項 |
|---|---|
| git commit 前 | `.env`, `*.pem`, `credentials.json`, およびローカルのシークレットファイルが gitignore されていること。`git status` に予期しない追加が含まれていないこと。 |
| PR 作成前 | 説明文、スクリーンショット、フィクスチャ、または「一時的な」デバッグファイルにキーが含まれていないこと。 |
| ワークフロー編集前 | シークレットは、プラットフォーム固有のシークレットメカニズムまたは OIDC/ワークロードアイデンティティから取得していること(YAML へのハードコードは不可)。 |
| CI デバッグ前 | `env`, `printenv`, またはログにシークレットを書き込む可能性のある詳細なダンプが含まれていないこと。 |
| 漏洩発生後 | まずローテーションを行い、その後に履歴やブランチをクリーンアップすること。スキャナーによる検知はインシデントのトリガーとして扱うこと。 |
デフォルトの経路にシークレットスキャンを追加してください:pre-commit フック (gitleaks)、CI スキャン、および GitHub Secret Scanning / push protection です。予防は、困難な履歴の書き換えよりも重要です。
GitHub にすでにシークレットが含まれている場合の対処法
以下の順序で行動してください:まずプロバイダーで認証情報をローテーションまたは無効化し、次に依存するセッションや Webhook を無効化し、その後デフォルトブランチからシークレットを削除します。コンプライアンスや公開の観点から履歴の書き換えが必要かどうかを判断してください。履歴を書き換えた後でも、フォーク、ミラー、キャッシュ、クローンにはコピーが残っている可能性があると想定し、それらには別途対処してください。
そのキーがアクセス可能なすべてのシステムの所有者に通知してください。クラウドの請求、アクセスログ、および異常な API の使用状況を確認してください。もしシークレットが Slack やメールにも貼り付けられていた場合は、それらのアーカイブにも含まれていると想定してください。詳細は なぜメールはシークレットの保管場所として最悪なのか および チャットで決して送るべきではないシークレット を参照してください。
暗号資産のシードフレーズのような極めて価値の高いシークレットについては、可能な限り送信を避けてください。その他の代替不可能なルート認証情報については、ウェブサイトに直接入力しないでください。まずローカルで暗号化し、必要な場合にのみ暗号文を共有してください。このモデルについては、当社の 暗号資産シードフレーズガイド で説明しています。
よくある質問
プライベートな GitHub リポジトリは .env ファイルにとって十分に安全ですか?
いいえ。プライベートリポジトリは露出を大幅に制限しますが、適切なシークレットストアではありません。アクセス権の変更、アカウントの侵害、クローン、バックアップ、およびサードパーティの統合により、過去のプレーンテキストが再浮上する可能性があります。シークレットは Git から完全に排除してください。
GitHub Actions のシークレットだけで十分ですか?
それらは多くの CI ランタイム値にとって適切な場所であり、YAML やリポジトリファイルよりもはるかに優れています。しかし、ヒューマンエラーによる流出、ログへの漏洩、過剰な権限、フォークされた PR のリスク、あるいは悪意のあるワークフローのステップや侵害された依存関係による露出の問題は解決できません。プラットフォーム固有のシークレットメカニズムを、最小権限の原則、慎重なロギング、そして可能であれば OIDC やワークロードアイデンティティによる短寿命の認証情報と組み合わせて使用してください。
内容を伏せ字にした .env.example をコミットすべきですか?
はい。変数名とダミーのプレースホルダーのみをコミットしてください。実際の値、あるいは「実物に近い」ステージング用のキー、パスワードを削除したもののホスト名やユーザー名が残っている本番環境の接続文字列などは、脅威モデルにおいて機密性が高い場合は決してコミットしないでください。
ローカルの .env ファイルは大丈夫ですか?
ローカル開発においては、適切に gitignore されており、決してコミットされないのであれば問題ありません。機密性の高い本番環境のシークレットは、理想的には開発者のマシン上のプレーンテキストの `.env` ファイルに永続的に置くべきではありません。実用的な場合には、パスワードマネージャー、短寿命のアクセス権、またはシークレットマネージャーを使用してください。
PrivateNote は Vault や GitHub のシークレットを代替できますか?
いいえ。PrivateNoteは安全な対人受け渡し用です。自動化には、CIプラットフォーム独自のシークレット機能や専用のシークレットマネージャーを使用してください。人がキー、トークン、または .env スニペットを受け取る必要がある場合は、Slack、メール、または GitHub に平文を残さないよう PrivateNote を使用してください。
最後に
GitHub と CI/CD は作業内容を保存することには非常に優れています。だからこそ、それらはシークレットを保存する場所としては不適切なのです。
`.env` ファイルはローカルに保持し、可能な限り gitignore に設定して、開発環境のみに限定してください。自動化用の認証情報は、ネイティブのCIシークレット、シークレットマネージャー、または短寿命のOIDC認証情報に保存してください。人間が値を確認する必要がある場合は、クライアントサイドで暗号化されたワンタイムノートを使用し、その後ローテーションを行ってください。
チームがまだPRにキーを貼り付けたり、「ステージング用」として認証情報をコミットしたりしている場合は、まず API キー共有ワークフロー と上記のチェックリストを確認してください。サーバーアクセス用の素材については、SSHキーを安全に共有する方法 を参照してください。安全な選択肢が迅速な選択肢となるよう、CLI、VS Code 拡張機能、または Chrome 拡張機能 を最も抵抗の少ない経路に組み込んでください。
シークレットを共有しましょう。永続的なコピーではなく。
チャットやGitに到達する前に、Webアプリ、CLI、VS Code / Cursor、または Chrome 拡張機能を使用して、CIトークンや .env スニペットを PrivateNote でローカルに暗号化してください。有効期限を短く設定するか、閲覧後に消去(burn-after-read)するようにし、平文の代わりにワンタイムノートのリンクを送信して、Gitやパイプラインの履歴に生の認証情報が残らないようにしてください。
プライベートメモを作成