CI/CDセキュリティ
GitHub Actionsのセキュリティ:ワークフローを強化するためのチェックリスト
GitHub Actionsのワークフローは、多くの作者によるコードを、リポジトリのトークン、シークレット、本番環境への経路とともに実行します。安全を保つための制御の多くはGitHubに組み込まれていますが、デフォルトでは無効だったり、緩かったり、設定を誤りやすかったりします。このチェックリストでは、それぞれについて、何を設定するか、なぜ重要か、そしてそれがないと何が起きるかを示したインシデントを解説します。
更新日
チェックリストの概要
| 項目 | 防げること |
|---|---|
最小権限のGITHUB_TOKEN |
乗っ取られたステップによるコードのプッシュ、リリースの公開、他のワークフローの起動 |
| サードパーティのアクションを固定またはロックする | 移動されたタグによって攻撃者のコードがジョブ内で実行されること |
pull_request_targetとworkflow_runを特権として扱う |
pwn request:フォークのコードがシークレットとともに実行されること |
イベントデータをrunスクリプトに入れない |
タイトル、ブランチ名、コメントを通じたスクリプトインジェクション |
| 保存したクラウドキーではなくOIDCを使う | 漏えい後も何年も使える長期間有効な認証情報 |
| 必須レビュアーを設定したEnvironment | あらゆるブランチやワークフローが本番のシークレットを読み取れること |
.github/workflowsにコードオーナーを設定する |
パイプラインで実行される内容へのレビューされていない変更 |
| 許可するアクションのポリシー | 組織内のあらゆる場所での不明なアクションや固定されていないアクション |
| パブリックリポジトリでセルフホステッドランナーを使わない | 見知らぬ人が自社のマシンでコードを実行すること |
| キャッシュとアーティファクトの衛生管理 | 汚染されたキャッシュと、アップロードを通じたトークンの漏えい |
| ランナーのエグレス制御 | 盗まれたシークレットが攻撃者のサーバーに送信されること |
| 各実行の記録 | 侵害されたアクションやパッケージを実行したビルドがわからないこと |
ワークフローのコード
1. GITHUB_TOKENに最小権限を与える
すべてのジョブにはGITHUB_TOKENが与えられ、ジョブ内のどのステップもそれを使えます。2023年2月より前に作成されたリポジトリや組織では、いまだにすべての権限が読み取りと書き込みにデフォルト設定されている場合があります。
Settings → Actions → General → Workflow permissionsでデフォルトを読み取り専用に設定し、書き込みアクセスはジョブごとに付与してください。
permissions:
contents: read
jobs:
release:
runs-on: ubuntu-latest
permissions:
contents: write
steps:
- uses: actions/checkout@<full-commit-sha>
記載しなかった権限はすべてnoneになります。各権限と一般的なタスクに必要な権限については、
GITHUB_TOKENの権限:すべてのワークフローに最小権限ををご覧ください。
2. サードパーティのアクションをコミットに固定する、またはロックする
@v4のようなタグは、アクションのオーナー、あるいはそのアクセス権を盗んだ人なら誰でも移動できるポインターです。それが何を意味するかを2つのインシデントが示しています。
- tj-actions/changed-files、2025年3月。攻撃者が 既存のバージョンタグを書き換え、悪意のあるコミットを指すようにしました(CVE-2025-30066)。このアクションは23,000を超えるリポジトリで使われており、ペイロードはランナーのメモリからシークレットをワークフローログに出力しました。パブリックリポジトリでは、このログは誰でも読めます。
- aquasecurity/trivy-action、2026年3月。Aqua Securityの アドバイザリ (CVE-2026-33634)によれば、このアクションの77個のバージョンタグのうち76個が悪意のあるコミットに強制プッシュされました。注入されたコードは本来のスキャンの前に実行され、ランナーのメモリからシークレットを読み取り、暗号化して攻撃者のインフラに送信しました。
完全なコミットSHAを参照していたワークフローは、それまでと同じコードを実行し続けました。バージョンはコメントとして残しておきます。
steps:
# Mutable: whoever controls the tag decides what runs
- uses: tj-actions/changed-files@v45
# Immutable: a full commit SHA, with the version as a comment
- uses: tj-actions/changed-files@<full-commit-sha> # v46.0.1
SHAがフォークではなく、アクション自身のリポジトリのものであることを確認してください。GitHubは現在、より強力な仕組みとして
ワークフロー依存関係のロックファイルを提供しており、2026年10月28日から一般提供されています。gh actions-lock CLI拡張機能が.github/workflows/actions.lockを書き出します。このファイルには、ワークフローが使うすべてのアクションの正確なコミットが、アクションが呼び出すアクションも含めて記録され、GitHubは実行時に各ソースリポジトリがロックしたものと同じであることを確認します。再利用可能なワークフローの呼び出しは対象外のため、それらはSHAで固定してください。管理者はポリシーでロックファイルを必須にできます。固定もロックファイルも、アクションを安全にするものではありません。ロックする内容はレビューしてください。
固定したアクションは自動では更新されません。Dependabotに更新を提案させ、クールダウンを設定して、新しいリリースが届く前に問題が発見されるまでの数日間を確保しましょう。
# .github/dependabot.yml
version: 2
updates:
- package-ecosystem: "github-actions"
directory: "/"
schedule:
interval: "weekly"
cooldown:
default-days: 7
3. pull_request_targetとworkflow_runを特権として扱う
フォークからのpull_requestワークフローには、読み取り専用のトークンが与えられ、シークレットは与えられません。
pull_request_targetワークフローは、プルリクエストがフォークからのものであっても、ベースリポジトリのコンテキストで、そのシークレットと書き込み可能なトークンとともに実行されます。これが安全なのは、ワークフローがプルリクエストのコードを一切実行しない間だけです。プルリクエストのheadをチェックアウトしてビルドすれば、そのプルリクエスト内のすべてのインストールスクリプトとテストがシークレットとともに実行されます。GitHub Security Labはこれを
pwn requestと呼んでいます。
- コントリビュートされたコードをビルドまたはテストするものには、
pull_requestを使ってください。 -
プルリクエストへのコメントなど、特権が必要なステップを後に続ける必要がある場合は分割します。特権のない
pull_requestワークフローが結果をアーティファクトとしてアップロードし、workflow_runワークフローがそれに基づいて処理します。これらのアーティファクトは信頼できない入力として扱い、実行するコードとしては決して扱わないでください。 -
イベントポリシーのないパブリックリポジトリでは、2026年12月2日からGitHubが
pull_request_targetをデフォルトでブロックします。再び許可する場合は、それを必要とするワークフローだけを許可してください。
2026年5月のTanStackの侵害はこのようにして始まりました。pull_request_targetワークフローがフォークのコードを実行し、そのコードがリリースワークフローが後で復元するキャッシュを汚染しました。そして、ランナーのメモリから読み取られたOIDCトークンが使われ、
42パッケージの悪意のあるバージョン84個が公開されました。
4. イベントデータをrunスクリプトに入れない
式はシェルが実行される前に展開されるため、run内のプルリクエストのタイトル、ブランチ名、issueの本文、コミットメッセージはスクリプトの一部になります。そうなると、プルリクエストやissueを作成できる人なら誰でも、ジョブ内でコマンドを実行できてしまいます。値は環境変数を通して渡し、シェルがデータとして扱うようにしてください。
# Vulnerable: the title is pasted into the script before the shell runs
- run: echo "Checking ${{ github.event.pull_request.title }}"
# Safe: the shell reads the title as data
- env:
PR_TITLE: ${{ github.event.pull_request.title }}
run: echo "Checking $PR_TITLE"
同じことがactions/github-scriptと、GITHUB_ENVに書き込む値にも当てはまります。ワークフロー内のAIエージェントは、同じ問題の新しい形をもたらします。issue内のテキストが、シェルではなくエージェントを操ってしまうのです。
プロンプトインジェクションをご覧ください。
シークレットとデプロイ
5. 長期間有効なクラウドキーではなくOIDCを使う
シークレットとして保存したクラウドのアクセスキーは、誰かがローテーションするまで有効なままです。漏えいした後では、それでは手遅れになることがよくあります。OpenID Connectでは、ジョブがGitHubに短期間有効なトークンを要求し、それをAWS、Azure、Google Cloudと交換します。どのリポジトリ、ブランチ、Environmentがロールを引き受けられるかは、クラウド側の信頼ポリシーが決めます。
jobs:
deploy:
runs-on: ubuntu-latest
environment: production
permissions:
contents: read
id-token: write
steps:
- uses: aws-actions/configure-aws-credentials@<full-commit-sha>
with:
role-to-assume: arn:aws:iam::123456789012:role/deploy
aws-region: us-east-1
TanStackの事例が示したように、短期間有効なトークンも実行中のジョブから盗まれる可能性はありますが、有効期限のないキーに比べればその価値ははるかに小さくなります。引き続き保持するシークレットは、ジョブ全体ではなく、それを必要とするステップに渡してください。そうすれば、ジョブ内の他のアクションはそれを読み取れません。シークレットが漏えいする経路とその他の制御については、 GitHub Actionsのシークレット:漏えいの経路と保護の方法をご覧ください。
6. 必須レビュアーを設定したEnvironmentで本番環境を保護する
Environmentは独自のシークレットを保持し、そのEnvironmentを指定したジョブは、必須レビュアーが実行を承認するまでシークレットを読み取れません。デプロイブランチのルールで、そもそもどのブランチがEnvironmentを使えるかを制限できます。これにより、フィーチャーブランチ上のワークフローや、プルリクエストによって起動されたワークフローには、本番の認証情報への経路がなくなります。
ガバナンス
7. ワークフローファイルにコードオーナーのレビューを必須にする
ワークフローファイルは、シークレットとともに何が実行されるかを決めます。そのため、ワークフローファイルの変更には、本番環境へのアクセス権の変更と同じレビューがふさわしいのです。フォルダーをCODEOWNERSに追加し、ブランチのルールセットでコードオーナーのレビューを必須にしてください。
/.github/workflows/ @example-org/platform-security
/.github/actions/ @example-org/platform-security
8. 実行できるアクションを制限する
Enterprise、組織、リポジトリの各レベルで、許可するアクションのポリシーにより、アクションをGitHub製、認証済みの作成者によるもの、または自社で管理するリストにあるものに制限できます。
2025年8月以降は、SHAでの固定を必須にして、固定されていないアクションを使うワークフローを失敗させることや、!エントリで特定のアクションやバージョンをブロックすることもできます。後者は、使用中のアクションが侵害されたと報告された日に役立ちます。
ランナー、キャッシュ、アーティファクト
9. パブリックリポジトリでセルフホステッドランナーを使わない
GitHubの安全な使用に関するリファレンスには、誰でもプルリクエストを作成してコードを実行できるため、パブリックリポジトリにセルフホステッドランナーはほぼ決して使うべきではないと書かれています。プライベートリポジトリでは、ジョブごとにクリーンな状態で起動するランナーを使ってください。長期間稼働するランナーは、あるジョブが残したものを、バックドアも含めて次のジョブに引き継いでしまいます。npmワームのShai-Huludは、まさにその理由から、感染したマシンをセルフホステッドランナーとして登録しました。 マネージドランナーとセルフホステッドランナーの比較をご覧ください。
10. キャッシュを汚染から守る
キャッシュはブランチ単位でスコープされ、デフォルトブランチで保存されたキャッシュは他のすべてのブランチから復元できます。そのため、デフォルトブランチ上の任意のワークフローで実行されるコードは、書き込みトークンがなくても、リリースワークフローが後で復元するキャッシュエントリを書き込めます。信頼できないコードをデフォルトブランチのワークフローに入れないようにし、リリースジョブや公開ジョブではキャッシュの復元を避け、代わりにロックファイルからビルドし直してください。 GitHub Actionsのキャッシュの仕組みをご覧ください。
11. アーティファクトを信頼できないものとして扱う
actions/checkoutは、無効にしない限り、後のgitコマンドのためにトークンをディスク上に保持します。過去には、ワークスペースをアーティファクトとしてアップロードしたことで、このトークンが漏えいしました。プッシュしないチェックアウトではpersist-credentials: falseを設定し、必要なパスだけをアップロードし、特権ワークフローではプルリクエストからのアーティファクトを決して実行しないでください。
- uses: actions/checkout@<full-commit-sha>
with:
persist-credentials: false
ネットワークと記録
12. ジョブの接続先を制御する
GitHubホステッドランナーは外向きの通信を制限しないため、ジョブ内のコードは読み取ったものをどこにでも送信できます。ほとんどのジョブに必要な接続先は、パッケージレジストリ、コンテナレジストリ、ソースホスト、いくつかのAPIといった短いリストです。それらを許可して残りをブロックすれば、誰も見たことのない攻撃であっても、盗まれたシークレットには送信先がありません。エグレスポリシーは、tj-actionsの事例のようにログに出力されたシークレットは防げません。だからこそ、固定の代わりではなく、固定と併用すべきものです。 エグレスポリシーがGitHub Actionsからの持ち出しを防ぐ仕組みをご覧ください。
13. 各実行で使われたアクションとパッケージを記録する
次に侵害されたアクションやパッケージが発表されたとき、最初の疑問は、自社のどの実行がそれを使ったかです。ワークフローファイルが示すのは、実行で使われるはずだったものです。タグ、バージョン範囲、キャッシュヒットによって答えが変わることがあり、それを確定できる記録は、ジョブの実行中に取られたものです。各アクションのコミット、取得またはキャッシュから復元されたすべてのパッケージ、ジョブが行った接続です。 GitHub ActionsでのSBOMをご覧ください。
ワークフローを監査する無料ツール
上記のワークフロー項目のほとんどは自動でチェックできます。これらのツールはワークフローファイルを読み取るものであり、実行中のジョブを監視するものではありません。
| ツール | チェック内容 |
|---|---|
| zizmor | GitHub Actions、Dependabot、pre-commitの設定の静的解析:テンプレートインジェクション、危険なトリガー、過剰な権限、固定されていないアクション、なりすましコミット、キャッシュポイズニング、チェックアウトが残す認証情報 |
| actionlint |
ワークフローの構文と式のリンター。インラインスクリプトで使われる信頼できない値にもフラグを付け、runステップに対してshellcheckを実行します
|
| OpenSSF Scorecard | Dangerous-Workflow(信頼できないチェックアウトとスクリプトインジェクション)、Token-Permissions、Pinned-Dependenciesを含むリポジトリのチェック |
| poutine | BoostSecurityによるビルドパイプライン向けのオープンソーススキャナー。GitHub Actions、GitLab、Azure DevOps、Tektonに対応し、組織内のすべてのリポジトリをスキャンできます |
| CodeQL | GitHubのコードスキャン。2025年から、ワークフローのインジェクションやpwn requestのパターンを解析しています |
.github/に関わるプルリクエストで、いずれかを実行してください。これらのツールとランナー側の制御やポスチャーツールとの組み合わせ方については、CI/CDセキュリティツールの比較と
CI/CDセキュリティをご覧ください。GitHub Actionsの設定ではなくパイプライン全体を対象とするチェックリストについては、CI/CDパイプラインのセキュリティチェックリストをご覧ください。
CRACIが役立つこと
CRACIが置き換えるのはランナーであり、GitHub Actionsではありません。runs-onをcraciに変更するだけで、ワークフロー、シークレット、トークンの権限、実行履歴はGitHubに残ります。CRACIが対応するのは、このリストの最後の項目、つまりジョブの実行中に起きることです。
- エグレス制御。エグレスポリシーによって、ジョブがアクセスできるパッケージソース、レジストリ、ホストを決めます。ポリシーはジョブの開始前に検証され、ランナーで適用され、フェイルクローズで動作し、ブロックされた接続はアラートを発生させます。
-
各実行の記録。ジョブのSBOMには、実行したGitHub Actionsが、使用されたコミットに固定された
pkg:githubコンポーネントとして記載されます。さらに、キャッシュから復元されたパッケージを含め、取得したすべてのパッケージが、ネットワーク接続のトレースとともに記載されます。アクションのタグが移動されても、各実行が実際にどのコミットを実行したかを確認できます。 - ポリシーゲート。特定のCVEを含め、既知の脆弱性のあるパッケージを取り込むビルドを停止できます。
- 分離。各ジョブは専用の仮想マシンで実行されるため、次のジョブに何も引き継がれません。
CRACIはワークフローファイルの監査、ソースコードのスキャン、シークレットのスキャンは行いません。それらには、zizmorなどのワークフローリンター、GitHubのシークレットスキャン、SASTツールを引き続きお使いください。CRACIはLinux上でGitHub Actionsのジョブを実行し、その他のCIシステムはロードマップに掲載されています。
GitHub Actionsのセキュリティ:よくあるご質問
GitHub Actionsを安全にするにはどうすればよいですか?
GITHUB_TOKENを読み取り専用にして書き込みはジョブごとに付与し、サードパーティのアクションを固定またはロックし、pull_request_targetワークフローでプルリクエストのコードを実行しないようにし、イベントデータは環境変数を通してスクリプトに渡し、保存したクラウドキーではなくOIDCを使い、本番のシークレットをEnvironmentで保護し、ワークフローファイルのレビューを必須にし、ジョブの接続先を制御します。
GitHub ActionsはコミットSHAに固定すべきですか?
サードパーティのアクションについては、はい。2025年のtj-actions/changed-filesや2026年のtrivy-actionで起きたように、タグは別のコードに移動できますが、完全なコミットSHAは移動できません。GitHubのワークフローロックファイルはさらに踏み込み、アクションが呼び出すアクションもロックします。
pull_request_targetは危険ですか?
ワークフローがプルリクエストのコードを一切実行しない場合に限り安全です。フォークからでもベースリポジトリのシークレットと書き込みトークンとともに実行されるため、その中でフォークのコードをビルドすると、両方をプルリクエストの作成者に渡すことになります。GitHubは2026年12月2日から、イベントポリシーのないパブリックリポジトリでこれをデフォルトでブロックします。
pwn requestとは何ですか?
GitHub Security Labによる呼び名で、通常はpull_request_targetで起動される特権ワークフローが、プルリクエストの信頼できないコードをチェックアウトして実行し、作成者にワークフローのシークレットとトークンへのアクセスを与えてしまうことを指します。
ワークフローロックファイルはSHAでの固定より優れていますか?
より強力です。ロックファイルは、推移的なものも含め、ワークフローが使うすべてのアクションのコミットを記録し、GitHubは実行時にソースリポジトリの同一性を確認します。再利用可能なワークフローの呼び出しは対象外のため、それらはSHAで固定してください。
GitHub Actionsのワークフローのセキュリティ問題をチェックできる無料ツールは?
zizmor、actionlint、OpenSSF Scorecard、poutineは無料で、CodeQLはGitHubのコードスキャンの一部としてワークフローを解析できます。これらはワークフローファイルを読み取るものであり、ジョブが実行中に何をするかを制御するものではありません。
ワークフローが実際に何を実行したかを確認する
GitHub ActionsのジョブをCRACIで実行し、すべてのアクションのコミット、取得したすべてのパッケージ、フェイルクローズで動作するエグレスポリシーを手に入れましょう。
デモを予約