INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN準備中

テーマ別の解説テーマ:GitHub Actionsの配信トラブル

GitHub ActionsでAWSのOIDC認証が拒否されたときの確認順

AWSのロールを引き受けられないときは、トークン取得、信頼条件、ロール取得後の権限を順に切り分けます。 同じリポジトリでも、配信先のEnvironmentが変わると信頼条件の照合結果が変わる場合があります。

この教材で学ぶこと

ジョブが失敗した境界を選び、発行者・受け手・主体を秘密値なしで照合する。

先に知っておくこと

GitHub ActionsがAWSへOIDC認証する構成の、架空のジョブと設定を扱います。実トークンや運用設定は使いません。

信頼条件の照合を、ロール取得後の操作と区別する

GitHubのOIDCトークンには発行者、audience、subjectがあり、AWSは設定したプロバイダーとロールの信頼条件に沿って受け入れます。対象のジョブがどの形式のsubjectを発行するかはGitHubの設定と参照先を確認します。

認証に失敗した架空ジョブの切り分け
認証に失敗した架空ジョブの切り分け1: 認証ジョブ — 失敗した段階を選ぶ — OIDC取得. 2: OIDC取得 — 許可対象との差分を確認 — 信頼を照合. 3: 信頼を照合 — 認証済みの場合だけ確認する — 許可操作123認証ジョブOIDC取得信頼を照合許可操作認証に失敗した架空ジョブの切り分け1: 認証ジョブ — 失敗した段階を選ぶ — OIDC取得. 2: OIDC取得 — 許可対象との差分を確認 — 信頼を照合. 3: 信頼を照合 — 認証済みの場合だけ確認する — 許可操作123認証ジョブOIDC取得信頼を照合許可操作
  1. 認証ジョブ → OIDC取得失敗した段階を選ぶ
  2. OIDC取得 → 信頼を照合許可対象との差分を確認
  3. 信頼を照合 → 許可操作認証済みの場合だけ確認する
認証ジョブ
実行した環境を特定
OIDC取得
取得に成功したか
信頼を照合
発行者・audience・subject
許可操作
取得後の権限を別に確認

許可した環境とジョブの環境を比べる

役割名も値も教材用。文字列の形式は省略し、論理的な照合条件だけを表示
比較項目信頼側で許可した条件失敗したジョブ
発行者GitHub ActionsGitHub Actions
受け手AWS STSAWS STS
主体に含まれる環境stagingproduction

発行者と受け手は一致しても、許可した環境と対象ジョブが違えばこの固定例では拒否されます。実環境では、リポジトリ、Environment、既定または利用中のsubject形式を確認し、許可を緩める前にジョブ側の指定を確かめます。

機密値を残さず、失敗した段階の前提だけを検証する

トークンを取得できない。 ジョブがOIDCトークンを要求できる条件と、実行が必要な承認段階に到達しているかを確認します。トークン本体はログや問い合わせ資料に載せません。

ロールを取得できた。 後続のAWS操作だけが拒否された場合は、使っているロール、対象操作、対象資源を確認します。信頼元を拡張する判断に流用しません。

拒否理由に合った確認先を選ぶ

選択すると、正誤と理由が表示されます。

許可したEnvironmentと実行したEnvironmentだけが異なります。最初の確認は?
答えと理由を読む

正解:ジョブと許可対象の環境指定を確認する · 対象ジョブが本来どの環境へ配信するかを確かめます。

ロールを取得できず、後続処理は開始していません。対象は?
答えと理由を読む

正解:プロバイダーと信頼条件、ジョブの実行条件 · 失敗していない後続の権限より、取得段階の証拠を確認します。

ロール取得は成功し、特定の保存操作だけ拒否されました。次は?
答えと理由を読む

正解:ロール、対象操作、対象資源に適用される許可 · 取得後に許可される操作と資源条件を確認します。

確認して、自分の言葉で説明する

  1. 失敗がOIDC取得、ロール取得、取得後の操作のどれかを読む。
  2. 対象環境と主体の形式を合成記録に書く。
  3. 拒否した条件だけを照合し、既存の信頼範囲を維持する。
理解を確かめる: 環境が違うジョブで失敗しました。どの情報があれば秘密値を出さずに説明できますか?

失敗した段階、対象Environment、許可対象の条件、照合結果です。

トークン本体を共有せず、どの条件が一致しないか説明できます。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。