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

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

LEARNINGEN

テーマ別の解説テーマ:CI/CDの設計:検査から配信と回復まで

CI/CDの権限設計:実行主体・認証情報・AWSロールを分ける

CI/CDの権限は、誰の実行を信頼し、その実行へどの操作を許可するかで設計します。テストjobと配信jobへ同じ強い認証情報を渡す必要はありません。架空の配信先を使い、実行コード・認証・認可の境界を整理します。

この教材で学ぶこと

非信頼の検査と特権の配信を分離し、ロールの信頼条件と操作権限を別々に説明できる。

先に知っておくこと

IAMのロールは権限を引き受ける対象です。OIDCは外部の実行の身元を伝える連携方式。このページは権限の考え方を扱い、具体的なGitHub/AWS連携設定は既存のOIDC教材へ集約します。

実行コードと、認証された主体を分ける

配信要求で確認する5つの境界
CODE
実行する変更

未審査コードは特権処理から分離する。

JOB
実行の文脈

repository・ref・environment等を確認。

TRUST
身元を信頼する条件

許可した実行だけがロールへ進む。

SESSION
一時認証情報

取得後も有効期間中の扱いを守る。

OPERATION
対象への操作

操作・対象・条件の認可を別に評価。

権限の判断を分けた概念図です。本人確認だけで操作がすべて許可される、という意味ではありません。

runnerで動くコードは、人が画面へログインした操作とは別です。誰がworkflowを編集できるか、どの入力をコードとして実行するか、runnerへ何が残るかを確認します。repositoryを読めること、PRを作れること、配信権限を使えることは別の許可です。

例I1:検査と配信を別のjobにする

架空の公開ファイル置場へ送る例
実行必要な作業与えない権限
外部PRの検査非信頼の変更を隔離環境でテスト。必要なソースを読む。AWSへの配信、secret、特権runnerへのアクセス。
信頼した版のビルド採用した版と審査済み入力から成果物を作り記録する。将来必要かもしれない管理者権限。
許可した配信job検証した成果物を、指定環境の公開用prefixへ送る。無関係なバケット・IAM変更・不要な削除。

配信jobの作業を「公開用prefixへファイルを置く」と決めたなら、まず必要な操作と対象を列挙します。実際に必要な一覧取得・暗号化キー等の権限は方式ごとに確認し、必要性を確かめずに広い許可を追加しません。これは実ポリシーの完成例ではありません。

認証情報の種類で、渡せる操作は決まらない

資格情報の用途と注意点
材料役割確認する境界
GITHUB_TOKENjobの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として認証できても、取得した成果物が正しいとは限りません。別の実行が作ったファイルや改変されたファイルを配信しないよう、成果物の由来と中身の対応も検証します。身元と成果物の検証は補い合う工程です。

実装前に、権限の流れを説明できる状態にする

  1. 誰が変更・workflow・依存を編集できるか整理する。
  2. 非信頼コードを動かすjobと、配信するjobを分ける。
  3. 信頼するrepository・版・environment等の文脈を定める。
  4. 必要操作・対象・追加条件と有効期間を定める。
  5. 古い認証情報・ログ・runnerの残存状態を確認する。
  6. 許可ケースと拒否ケースを用意し、結果と記録を照合する。

具体的なGitHub ActionsとAWSのOIDC設定は、関連するOIDC教材で確認します。このページは権限を分ける設計を理解するためのもので、実際のtoken・ポリシー・認証情報の入力や保存は行いません。

信頼と操作の境界を確かめる

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

I1の外部PR検査へ、配信用AWS権限も渡す?
答えと理由を読む

正解:渡さない。検査に必要な権限へ分離する。 · 未審査コードへ配信の権限を渡さない境界です。

id-token: writeだけで、公開用バケットへ書ける?
答えと理由を読む

正解:いいえ。ロールの信頼と書込み権限を別に評価する。 · 身元を伝える材料から、AWSの許可が自動確定するわけではありません。

配信だけのjobへ管理者権限を与え、短期化すれば十分?
答えと理由を読む

正解:不十分。必要な操作と対象へ権限を絞る。 · 短期化と最小権限は別の対策です。

正しい配信jobが成果物Aを取得した。候補Bの配信としてよい?
答えと理由を読む

正解:だめ。候補の成果物と由来も照合する。 · 認証・認可に加え、配信する対象の検証が必要です。

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

  1. I1の検査と配信へ必要な権限を分ける。
  2. 三種類のtoken/認証情報の用途を区別する。
  3. I2の許可と拒否の理由を説明する。
  4. 実行主体と成果物の両方を確かめる。
理解を確かめる: ロールの信頼設定を通過した。必要なAPI操作もすべて成功する?

限りません。引受後のロール権限・対象・条件・他の制限等を評価します。また、許可されたjobでも成果物の取り違えや過剰権限を別に検査します。

誰を信頼するか、何を許すか、何を配信するかを別々の証拠で結びます。

出典と確認した条件

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