GitHub Actionsで外部actionを使う時の注意点|権限・version固定・Secrets確認

外部actionを使う時は、便利さだけでなく、何を実行し、どの権限を持ち、Secretsに触れるかを確認します。Codexが追加した場合もPRで見直します。

このページでわかること

  • third-party actionを見る時の確認軸がわかる
  • permissionsとSecretsの関係を確認できる
  • version固定やメンテナンス状況を見る理由がわかる

まず確認すること

  • どのactionを使うか確認する
  • 提供元、version指定、更新状況を見る
  • permissionsとSecretsを渡す必要があるか確認する
  • workflowログとPR差分を見る

やってはいけないこと

  • 外部actionを無条件に信頼しない
  • Secretsを不要に渡さない

安全寄りに進める手順

  1. 対象のrepo、branch、PR、Actions runを確認する。
  2. Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
  3. 必要な場合は値を停止または再発行し、影響範囲を整理する。
  4. 変更は小さなbranchとPRに分け、CIとreviewで確認する。

CodexやAI作業時の注意

AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。

一次情報で確認する領域

Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。

公式が示す、外部actionの固定と確認の方法

  • GitHub Docsは、第三者のリポジトリからactionを取り込むことには大きなリスクがあると警告しています。
  • commit SHAで固定する: actionの参照をcommit SHAにしておくと、悪意のある人がactionのリポジトリにバックドアを仕込むには、有効なgitオブジェクトでSHA-1の衝突を作る必要があり、そのリスクを減らせると公式は説明しています。選ぶSHAは、forkではなく、actionのリポジトリ由来かを確かめます。
  • タグ指定は、リポジトリへのアクセスを悪用されると、タグを動かされたり消されたりしうるとされています。タグで固定するのは、作成者を信頼できる場合に限るのが公式の立場です。「Verified creator」のバッジは、判断の材料の1つになります。
  • 公式はさらに、lockfile(workflowが依存するすべてのactionの正確なcommitを記録する仕組み)を、導入できるリポジトリではSHA固定より強い保護としています。lockfileの詳しい作り方は、公式の別の記事(Workflow dependency lockfiles)にあり、このページでは確かめていません。
  • 固定の方法にかかわらず、actionのソースコードを読んで、Secretsが意図しない宛先に送られたりログに出たりしないかを確認するよう公式は勧めています。

出典: Security hardening for GitHub Actions/確認日 2026年11月2日

権限・更新・レビューの組み合わせ

  • 権限: GITHUB_TOKEN の既定の権限を、リポジトリの内容を読むだけに絞り、必要なjobだけ権限を足す方法が、公式に挙げられています。
  • 更新: Dependabotのversion updatesは、actionの新しいバージョンが出た時にPRを開いて更新を提案します。公式は、SHAで固定したactionはDependabot alertsの対象にならないと書いているため、固定した後の更新は別の方法で追う必要があります。
  • レビュー: .github/workflows をCODEOWNERSに入れると、workflowの変更には指名した人の承認が先に必要になります。AIが外部actionを足したPRを、人が確認する流れを作れます。
  • Secrets: 値を1つのJSONやYAMLにまとめて1つのSecretにせず、別々のSecretに分けること、Secretから作った値もログで伏せ字になるように登録することが、公式に書かれています。

出典: Security hardening for GitHub Actions/確認日 2026年11月2日

関連ページ