テーマ別の解説テーマ:CI/CDの設計:検査から配信と回復まで
CI/CDの権限設計:実行主体・認証情報・AWSロールを分ける
CI/CDの権限は、誰の実行を信頼し、その実行へどの操作を許可するかで設計します。テストjobと配信jobへ同じ強い認証情報を渡す必要はありません。架空の配信先を使い、実行コード・認証・認可の境界を整理します。
非信頼の検査と特権の配信を分離し、ロールの信頼条件と操作権限を別々に説明できる。
IAMのロールは権限を引き受ける対象です。OIDCは外部の実行の身元を伝える連携方式。このページは権限の考え方を扱い、具体的なGitHub/AWS連携設定は既存のOIDC教材へ集約します。
実行コードと、認証された主体を分ける
未審査コードは特権処理から分離する。
repository・ref・environment等を確認。
許可した実行だけがロールへ進む。
取得後も有効期間中の扱いを守る。
操作・対象・条件の認可を別に評価。
権限の判断を分けた概念図です。本人確認だけで操作がすべて許可される、という意味ではありません。
runnerで動くコードは、人が画面へログインした操作とは別です。誰がworkflowを編集できるか、どの入力をコードとして実行するか、runnerへ何が残るかを確認します。repositoryを読めること、PRを作れること、配信権限を使えることは別の許可です。
例I1:検査と配信を別のjobにする
| 実行 | 必要な作業 | 与えない権限 |
|---|---|---|
| 外部PRの検査 | 非信頼の変更を隔離環境でテスト。必要なソースを読む。 | AWSへの配信、secret、特権runnerへのアクセス。 |
| 信頼した版のビルド | 採用した版と審査済み入力から成果物を作り記録する。 | 将来必要かもしれない管理者権限。 |
| 許可した配信job | 検証した成果物を、指定環境の公開用prefixへ送る。 | 無関係なバケット・IAM変更・不要な削除。 |
配信jobの作業を「公開用prefixへファイルを置く」と決めたなら、まず必要な操作と対象を列挙します。実際に必要な一覧取得・暗号化キー等の権限は方式ごとに確認し、必要性を確かめずに広い許可を追加しません。これは実ポリシーの完成例ではありません。
認証情報の種類で、渡せる操作は決まらない
| 材料 | 役割 | 確認する境界 |
|---|---|---|
| GITHUB_TOKEN | jobのGitHub API用token。 | 必要なrepository権限。AWS操作用ではない。 |
| OIDCのID token | 外部サービスへ身元と文脈を伝える。 | 発行元・aud・sub等の条件。要求許可とAWSの許可は別。 |
| AWSの一時認証情報 | 許可されたロールのセッションでAWSへ要求する。 | 有効期間・ロール権限・対象・追加の制限。 |
| 長期アクセスキー | 失効まで使われ得る認証材料。 | 保管・漏えい・ローテーションと不要キーの除去。 |
外部CIからAWSを使う構成でOIDCを採用できれば、長期AWSキーをCIへ保存せずに連携できます。ただし、信頼する文脈を広げすぎたり、過剰なロール権限を与えたりすれば影響は残ります。短期だからログへ出してよい、という扱いもしません。
例I2:ロールを引き受けられた後も、認可がある
I2では、owner/repository内の許可した配信文脈だけを信頼すると定めます。同じrepositoryでも外部PRの検査文脈は対象外です。実際のsubject形式やenvironmentの保護条件は構成・現在の仕様で確認し、文字列の雛形をそのまま流用しません。
| 要求 | I2での判断 | 理由 |
|---|---|---|
| 外部PRの検査からロール引受 | 許可しない | 配信として信頼する文脈と異なる。 |
| 許可した配信jobが公開用対象へ必要な書込み | 信頼と操作権限の両方を評価 | 引受と書込みを別に確認。実環境の成功保証ではない。 |
| 同じjobがIAMロールを書換え | 必要操作として許可しない | ファイル配信に不要。短期tokenでも管理者にはしない。 |
正しいjobとして認証できても、取得した成果物が正しいとは限りません。別の実行が作ったファイルや改変されたファイルを配信しないよう、成果物の由来と中身の対応も検証します。身元と成果物の検証は補い合う工程です。
実装前に、権限の流れを説明できる状態にする
- 誰が変更・workflow・依存を編集できるか整理する。
- 非信頼コードを動かすjobと、配信するjobを分ける。
- 信頼するrepository・版・environment等の文脈を定める。
- 必要操作・対象・追加条件と有効期間を定める。
- 古い認証情報・ログ・runnerの残存状態を確認する。
- 許可ケースと拒否ケースを用意し、結果と記録を照合する。
具体的なGitHub ActionsとAWSのOIDC設定は、関連するOIDC教材で確認します。このページは権限を分ける設計を理解するためのもので、実際のtoken・ポリシー・認証情報の入力や保存は行いません。
信頼と操作の境界を確かめる
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- I1の検査と配信へ必要な権限を分ける。
- 三種類のtoken/認証情報の用途を区別する。
- I2の許可と拒否の理由を説明する。
- 実行主体と成果物の両方を確かめる。
理解を確かめる: ロールの信頼設定を通過した。必要なAPI操作もすべて成功する?
限りません。引受後のロール権限・対象・条件・他の制限等を評価します。また、許可されたjobでも成果物の取り違えや過剰権限を別に検査します。
誰を信頼するか、何を許すか、何を配信するかを別々の証拠で結びます。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件Web identity tokenによる一時認証情報。既存AWSキーはこの要求の必要条件ではない。 公式資料の確認であり、実環境の検証ではありません。
確認した内容・条件IdP・ロールの信頼条件・引受後の権限とGitHub subject制約。 公式資料の確認であり、実環境の検証ではありません。
参照した本文実行コードと、認証された主体を分ける
確認した内容・条件第三者actionの不変commit参照と審査、非信頼入力・コードと特権処理の境界。 公式資料を確認。実GitHub/AWSの検証ではありません。
確認した内容・条件job用の一時tokenと対象repositoryの権限。AWSのtokenとは区別。 公式資料の確認であり、実環境の検証ではありません。
参照した本文認証情報の種類で、渡せる操作は決まらない
確認した内容・条件発行元・aud・sub、文脈によるsubject、2026-07-15以後のID入り形式とGHESの適用差。 公式資料の確認であり、実環境の検証ではありません。
確認した内容・条件公式AWS連携例のaudとsub条件。任意custom claimをAWSで使えるとはしない。 公式資料の確認であり、実環境の検証ではありません。
確認した内容・条件環境の保護・秘密へのアクセス前提、必須reviewer等のプラン/公開範囲、管理者bypassの設定差。 公式資料を確認。実GitHub/AWSの検証ではありません。
参照した本文例I2:ロールを引き受けられた後も、認可がある