テーマ別の解説テーマ:AWS統制とGitHub Actionsの配信運用
GitHub Actionsで2段目のAssumeRoleが拒否される|OIDCと引受先を分ける
初回のOIDCが成功しても、別アカウントの配信ロールへ進めるとは限りません。 配信前の2回の認証を分け、拒否された段階の信頼と許可を照合します。
この教材で学ぶこと
配信前の2回の認証を分け、拒否された段階の信頼と許可を照合します。
先に知っておくこと
架空の観測記録を読みます。実環境の操作は行いません。
トークン発行とAWS内の引受を別に追う
GitHub ActionsはOIDCでAWSへ連携できます。その後に別アカウントのロールを引き受ける場合、呼出元の許可と引受先の信頼が別に必要です。
- GitHubジョブ → 入口ロール初回成功を確認
- 入口ロール → 対象ロール信頼と権限を照合
- 対象ロール → 配信操作許可された操作を確認
- GitHubジョブ
- 環境条件を満たす
- 入口ロール
- OIDCで連携
- 対象ロール
- AWS間の引受
- 配信操作
- 限定した対象へ
初回成功の後で拒否が返る例
| 観測 | 状態 | 結論 |
|---|---|---|
| GitHubからOIDC | 成功 | 入口ロールの連携は成立 |
| 入口ロールの記録 | Aの読み取り限定 | 次の許可を別に確認 |
| BへのAssumeRole | 拒否 | 呼出側と対象側を照合 |
| Bへの配信 | 未実施 | 配信設定の問題と断定しない |
最初の信頼条件を広げて2段目の許可不足を直そうとしません。対象、環境、必要操作を維持して担当へ連携します。
停止した段階だけを調べる
初回の証拠を確認。 環境と実行ID、入口ロールまでの合否を分けて記録します。
2段目の両側を確認。 対象ロール、呼出元の許可、B側の信頼条件を合わせて読みます。
秘密値を記録しない。 引継ぎにはロールの用途・操作名・時刻・結果を使い、トークンは転記しません。
判断を確かめる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 初回と2段目の実行を分ける。
- 両側の条件を照合する。
- 配信の結果を別途確認する。
理解を確かめる: 入口ロールを得た時点で配信を成功と報告できますか?
対象ロールの引受と配信先の操作結果を別々に確認します。
認証結果は工程ごとに証拠が違います。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件GitHubジョブの初回の連携認証。
確認した内容・条件別アカウントの信頼と呼出元の権限。