テーマ別の解説テーマ:CI/CDの設計:検査から配信と回復まで
CI/CDのサプライチェーン対策:ハッシュ・依存・成果物の由来を検証する
配信する成果物は、ソースだけでなく依存・ビルド処理・保存先を経て届きます。 ハッシュの一致、信頼した作成元、必要な安全性の検査を分けて確認しましょう。GitHubのartifact attestations(成果物の由来を記した署名付きの証明)を具体例に、改変や取り違えを考えます。
ハッシュと署名付き由来の役割を分け、利用側のpolicyへ合わない成果物を止める理由を説明できる。
成果物はビルド等の出力。ハッシュは内容から計算する識別値で、署名は信頼する主体と記録の結び付きを検証する材料です。例は架空の検証観測を与えた問題で、実署名の生成・実workflow作成は行いません。
ソース以外の入力も、配信物へ影響する
変更と、取り込むコードの版を審査。
workflow・runner・権限・入力を確認。
出力のバイトと由来を対応させる。
期待した主体・版・中身か判定する。
供給の境界を整理した図です。各区画を通っただけで安全になる、という意味ではありません。
第三者action・再利用workflow・依存パッケージ・ビルド用イメージも、実行されるコードや入力です。直接指定した依存だけでなく、その先で読み込む依存も確認します。強いtokenやrunnerの共有状態へ触れる処理は、影響範囲を含めて審査します。
ハッシュの一致は、誰が作ったかまで示さない
成果物Bの正しいバイトから計算したハッシュを、信頼する記録へ保存したとします。取得したバイトのハッシュが違えば、同じ成果物ではありません。ただし、攻撃者がファイルと横に置いたchecksumの両方を変更できるなら、その2つの一致だけでは信頼できる元へ結び付きません。
| 観測 | 判断 |
|---|---|
| 信頼したBのハッシュと取得物のハッシュが不一致 | Bとして使わず、取り違えや改変を調べる。 |
| 取得物と同じ未信頼サイトのchecksumが一致 | そのサイト上の2値の一致。作成元の信頼は未確認。 |
| Bのハッシュと一致 | Bのバイトとの一致を確認。Bの内容が無害かは別。 |
署名付きの由来を、利用側の条件で検証する
GitHubのartifact attestationsは、成果物とビルドの由来を署名付きで結び付ける仕組みです。利用側が検証してはじめて、その由来を採用判断に使えます。証明を生成しただけで、利用側の確認が済むわけではありません。
架空S2の利用側は、「候補のバイトB」「期待するrepository」「審査した署名側workflow」「対象ソースの版」を照合すると決めます。署名の検証が通っても、別repositoryや検査用workflowなら条件外です。A/Bは短い説明用名であり、実際のハッシュ表記ではありません。
| 観測 | policyでの判断 | 残る確認 |
|---|---|---|
| Bのバイト、署名検証成功、期待したrepository/workflow/版 | 由来の条件は一致 | 内容・依存・必要なテストと公開条件。 |
| Bを改変したバイト、証明は元のBを指す | 対象不一致で停止 | 取得元と保存・転送経路を調査。 |
| Bのバイト、署名検証成功、別repository | 作成元の条件外で停止 | 信頼する元を勝手に広げない。 |
| Bのバイト、同repositoryだが別の検査用workflow | 署名側の条件外で停止 | 公開候補を作るworkflowを確認。 |
検証toolが確認した証明書の主体と、workflowが任意に書いた説明文を混同しません。再利用workflowを使う場合、検証する署名側のidentityもその構成に対応させます。repository名だけを指定した検証と、署名側workflowやソース条件まで絞った検証は同じではありません。
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は変更され得るため、対象環境の対応を確認して採否を決めます。 この教材では拡張の導入や設定変更はしません。
- ソース・依存・workflow・runner・保存先を列挙する。
- 何を信頼し、何を拒否するかを利用側で決める。
- 成果物のバイトと、署名側・ソース条件の対応を検証する。
- 改変・別repository・別workflow・古い版のケースで拒否を確かめる。
- 由来が合っても、内容審査と公開前の検査を継続する。
成果物の検証範囲を読み分ける
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- ハッシュの一致から言えることを限定する。
- S2の改変・別repository・別workflowを区別する。
- 由来の一致と安全性を分ける。
- 機能の利用条件と依存更新の審査を確認する。
理解を確かめる: 由来の証明を生成したので、配信jobは確認せずBを使ってよい?
いいえ。取得したBのバイトと、信頼するrepository・署名側workflow・必要なソース条件を利用側で検証します。その後も内容・依存・必要なテストと公開判定は別に確認します。
作った記録が存在することと、使う側が必要な条件を検証したことは別です。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件第三者actionの不変commit参照と審査、非信頼入力・コードと特権処理の境界。 公式資料を確認。実GitHub/AWSの検証ではありません。
確認した内容・条件生成だけでは防御にならず利用側で検証する。署名付き由来とソフトウェアの安全性を区別する。 公式資料を確認。実GitHub/AWSの検証ではありません。
確認した内容・条件成果物・repository・signer workflow・source等のpolicy条件。reusable workflowは署名側のidentityを確認。predicateの任意記録を信頼根拠にしない。 公式資料を確認。実GitHub/AWSの検証ではありません。
参照した本文署名付きの由来を、利用側の条件で検証する
確認した内容・条件build provenanceの生成と利用側の検証。Free/Pro/Teamはpublic限定、private/internalはEnterprise Cloudが必要、旧プラン対象外。無害性の証明ではない。 公式資料を確認。実GitHub/AWSの検証ではありません。
参照した本文機能の利用条件と、保証しないことを確かめる
確認した内容・条件2026-10-25時点public preview。actionの推移的依存を含む固定、repository ID、再利用workflowの依存は定義先のlockfileが担当。導入や拡張の実行は未実施。 公式資料を確認。実GitHub/AWSの検証ではありません。
参照した本文依存の固定と、更新の審査を両立する