テーマ別の解説テーマ:GitHub Actionsの配信トラブル
GitHub ActionsでAWSのOIDC認証が拒否されたときの確認順
AWSのロールを引き受けられないときは、トークン取得、信頼条件、ロール取得後の権限を順に切り分けます。 同じリポジトリでも、配信先のEnvironmentが変わると信頼条件の照合結果が変わる場合があります。
ジョブが失敗した境界を選び、発行者・受け手・主体を秘密値なしで照合する。
GitHub ActionsがAWSへOIDC認証する構成の、架空のジョブと設定を扱います。実トークンや運用設定は使いません。
信頼条件の照合を、ロール取得後の操作と区別する
GitHubのOIDCトークンには発行者、audience、subjectがあり、AWSは設定したプロバイダーとロールの信頼条件に沿って受け入れます。対象のジョブがどの形式のsubjectを発行するかはGitHubの設定と参照先を確認します。
- 認証ジョブ → OIDC取得失敗した段階を選ぶ
- OIDC取得 → 信頼を照合許可対象との差分を確認
- 信頼を照合 → 許可操作認証済みの場合だけ確認する
- 認証ジョブ
- 実行した環境を特定
- OIDC取得
- 取得に成功したか
- 信頼を照合
- 発行者・audience・subject
- 許可操作
- 取得後の権限を別に確認
許可した環境とジョブの環境を比べる
| 比較項目 | 信頼側で許可した条件 | 失敗したジョブ |
|---|---|---|
| 発行者 | GitHub Actions | GitHub Actions |
| 受け手 | AWS STS | AWS STS |
| 主体に含まれる環境 | staging | production |
発行者と受け手は一致しても、許可した環境と対象ジョブが違えばこの固定例では拒否されます。実環境では、リポジトリ、Environment、既定または利用中のsubject形式を確認し、許可を緩める前にジョブ側の指定を確かめます。
機密値を残さず、失敗した段階の前提だけを検証する
トークンを取得できない。 ジョブがOIDCトークンを要求できる条件と、実行が必要な承認段階に到達しているかを確認します。トークン本体はログや問い合わせ資料に載せません。
ロールを取得できた。 後続のAWS操作だけが拒否された場合は、使っているロール、対象操作、対象資源を確認します。信頼元を拡張する判断に流用しません。
拒否理由に合った確認先を選ぶ
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 失敗がOIDC取得、ロール取得、取得後の操作のどれかを読む。
- 対象環境と主体の形式を合成記録に書く。
- 拒否した条件だけを照合し、既存の信頼範囲を維持する。
理解を確かめる: 環境が違うジョブで失敗しました。どの情報があれば秘密値を出さずに説明できますか?
失敗した段階、対象Environment、許可対象の条件、照合結果です。
トークン本体を共有せず、どの条件が一致しないか説明できます。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件GitHub OIDCの発行者、audience、jobのsub・Environment形式。
参照した本文信頼条件の照合を、ロール取得後の操作と区別する 許可した環境とジョブの環境を比べる 機密値を残さず、失敗した段階の前提だけを検証する