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

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

LEARNINGEN

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

CI/CDのサプライチェーン対策:ハッシュ・依存・成果物の由来を検証する

配信する成果物は、ソースだけでなく依存・ビルド処理・保存先を経て届きます。 ハッシュの一致、信頼した作成元、必要な安全性の検査を分けて確認しましょう。GitHubのartifact attestations(成果物の由来を記した署名付きの証明)を具体例に、改変や取り違えを考えます。

この教材で学ぶこと

ハッシュと署名付き由来の役割を分け、利用側のpolicyへ合わない成果物を止める理由を説明できる。

先に知っておくこと

成果物はビルド等の出力。ハッシュは内容から計算する識別値で、署名は信頼する主体と記録の結び付きを検証する材料です。例は架空の検証観測を与えた問題で、実署名の生成・実workflow作成は行いません。

ソース以外の入力も、配信物へ影響する

配信物が通る4つの確認点
SOURCE
ソースと依存

変更と、取り込むコードの版を審査。

BUILD
ビルドの実行

workflow・runner・権限・入力を確認。

ARTIFACT
保存する成果物

出力のバイトと由来を対応させる。

CONSUMER
使う側の検証

期待した主体・版・中身か判定する。

供給の境界を整理した図です。各区画を通っただけで安全になる、という意味ではありません。

第三者action・再利用workflow・依存パッケージ・ビルド用イメージも、実行されるコードや入力です。直接指定した依存だけでなく、その先で読み込む依存も確認します。強いtokenやrunnerの共有状態へ触れる処理は、影響範囲を含めて審査します。

ハッシュの一致は、誰が作ったかまで示さない

成果物Bの正しいバイトから計算したハッシュを、信頼する記録へ保存したとします。取得したバイトのハッシュが違えば、同じ成果物ではありません。ただし、攻撃者がファイルと横に置いたchecksumの両方を変更できるなら、その2つの一致だけでは信頼できる元へ結び付きません。

S1:照合する記録の出所も重要
観測判断
信頼したBのハッシュと取得物のハッシュが不一致Bとして使わず、取り違えや改変を調べる。
取得物と同じ未信頼サイトのchecksumが一致そのサイト上の2値の一致。作成元の信頼は未確認。
Bのハッシュと一致Bのバイトとの一致を確認。Bの内容が無害かは別。

署名付きの由来を、利用側の条件で検証する

GitHubのartifact attestationsは、成果物とビルドの由来を署名付きで結び付ける仕組みです。利用側が検証してはじめて、その由来を採用判断に使えます。証明を生成しただけで、利用側の確認が済むわけではありません。

架空S2の利用側は、「候補のバイトB」「期待するrepository」「審査した署名側workflow」「対象ソースの版」を照合すると決めます。署名の検証が通っても、別repositoryや検査用workflowなら条件外です。A/Bは短い説明用名であり、実際のハッシュ表記ではありません。

S2:与えられた検証観測から判断する
観測policyでの判断残る確認
Bのバイト、署名検証成功、期待したrepository/workflow/版由来の条件は一致内容・依存・必要なテストと公開条件。
Bを改変したバイト、証明は元のBを指す対象不一致で停止取得元と保存・転送経路を調査。
Bのバイト、署名検証成功、別repository作成元の条件外で停止信頼する元を勝手に広げない。
Bのバイト、同repositoryだが別の検査用workflow署名側の条件外で停止公開候補を作るworkflowを確認。

検証toolが確認した証明書の主体と、workflowが任意に書いた説明文を混同しません。再利用workflowを使う場合、検証する署名側のidentityもその構成に対応させます。repository名だけを指定した検証と、署名側workflowやソース条件まで絞った検証は同じではありません。

公式CLIの確認コマンドの形:このページでは実行しない
gh attestation verify PATH/TO/ARTIFACT --repo OWNER/REPOSITORY
# Minimal repository-scoped verification shape only.
# Add the intended signer/source constraints to match your policy.

機能の利用条件と、保証しないことを確かめる

2026-10-25に確認したGitHub.comの条件では、Free/Pro/Teamでのartifact attestationsはpublic repositoryが対象です。private/internalで使うにはEnterprise Cloudが必要で、旧プランは対象外です。必要な機能が対象のrepositoryで使えるか、導入前に確認します。

依存の固定と、更新の審査を両立する

tagやbranchは参照先が動く可能性があります。第三者actionを確認した完全なcommitへ固定する場合も、その出所・中身・依存・権限を審査し、更新時に差分を確認します。固定した版を永久に放置することは、脆弱性への対応ではありません。

GitHubは現在、workflow dependency lockfilesもpublic previewとして案内しています。直接・推移的なactionの固定やrepositoryの識別を扱いますが、再利用workflow内の依存は定義先のlockfileが担当します。previewは変更され得るため、対象環境の対応を確認して採否を決めます。 この教材では拡張の導入や設定変更はしません。

  1. ソース・依存・workflow・runner・保存先を列挙する。
  2. 何を信頼し、何を拒否するかを利用側で決める。
  3. 成果物のバイトと、署名側・ソース条件の対応を検証する。
  4. 改変・別repository・別workflow・古い版のケースで拒否を確かめる。
  5. 由来が合っても、内容審査と公開前の検査を継続する。

成果物の検証範囲を読み分ける

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

未信頼サイトのファイルと、同サイトのchecksumが一致した。何が言える?
答えと理由を読む

正解:その2値は一致したが、信頼した由来は未確認。 · 信頼する比較記録や由来の検証が別に必要です。

S2で署名検証は成功したが、別repositoryの成果物だった。どうする?
答えと理由を読む

正解:条件外として停止し、意図した由来を確認する。 · 署名の検証と、利用側の信頼条件の一致が必要です。

期待した由来が一致したBに不具合があった。矛盾する?
答えと理由を読む

正解:矛盾しない。由来の一致は無欠陥の保証ではない。 · ソースとビルドの由来と、動作の品質を分けます。

Free/Pro/Teamのprivateで、artifact attestationsを当然使えるとする?
答えと理由を読む

正解:いいえ。現行の利用条件を確認する。 · 確認時点ではprivate/internalはEnterprise Cloudが必要です。

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

  1. ハッシュの一致から言えることを限定する。
  2. S2の改変・別repository・別workflowを区別する。
  3. 由来の一致と安全性を分ける。
  4. 機能の利用条件と依存更新の審査を確認する。
理解を確かめる: 由来の証明を生成したので、配信jobは確認せずBを使ってよい?

いいえ。取得したBのバイトと、信頼するrepository・署名側workflow・必要なソース条件を利用側で検証します。その後も内容・依存・必要なテストと公開判定は別に確認します。

作った記録が存在することと、使う側が必要な条件を検証したことは別です。

出典と確認した条件

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