
コンテナイメージの脆弱性スキャンをCI/CDに組み込む手順と、マージを止める基準
CI/CDでコンテナイメージをビルドしていても、検査はソースコードだけということがあります。イメージはビルド時の部品を固めたものなので、後から部品の脆弱性が公表されても、古い部品のまま配備され続けます。コンテナイメージの脆弱性スキャンを入れても、止める重大度を決めなければ結果の一覧が増えるだけです。
脆弱性を抱えたイメージを本番に送らないよう、まずスキャンを置く工程を決め、GitLabのコンテナスキャン、Amazon ECRの基本・拡張スキャン、他のCIでのTrivyの組み込みへ進みます。次に定義ファイル(IaC)の検査、最後に重大度でマージに承認を求める基準と、直す順番を扱います。
CI/CDに入れる、コンテナイメージを含む脆弱性スキャンの種類と位置
CI/CDに入れる脆弱性のスキャンは、調べる対象ごとに種類が分かれ、動かす工程も違います。コード、依存関係、イメージ、定義ファイルのどれを、どの工程で調べるかを先に一覧にしておくと、抜けている検査が見えます。
コードと依存関係のスキャン
GitLabの説明書「セキュリティスキャンの種類」は、リポジトリを調べるスキャンの例として、SAST(静的アプリケーションセキュリティテスト)、シークレット検出、依存関係スキャン、IaCスキャンを挙げています。
動くアプリケーションを用意して試す挙動テストと違い、これらはリポジトリの中身を実行せずに調べます。
GitHubでは、コード スキャンがリポジトリのコードを解析して脆弱性や誤りを見つけます。GitHubのCodeQLのほか、共通の形式(SARIF)で結果を出す他のツールの結果も取り込めます。プライベートリポジトリでは、GitHub Code Securityのライセンスが要ります。
OSSのスキャナーであるTrivyは、1つのツールで複数の対象を調べます。ユーザーガイドによると、コンテナイメージ、ファイルシステム、コードのリポジトリ、Kubernetesのクラスターなどを対象に、脆弱性、設定の誤り、秘密の値、ライセンスなどを見つけます。
GitLabは依存関係スキャンの説明にコンテナイメージも含めていますが、この記事ではイメージのスキャンを別の行に分けました。調べる対象と動かす工程を並べると次の表のようになります。
| スキャンの種類 | 調べる対象 | 動かす工程 |
|---|---|---|
| SAST | 自社で書いたソースコード | マージ前 |
| シークレット検出 | コミットされる秘密の値 | マージ前 |
| 依存関係スキャン | 取り込んだ部品 | マージ前 |
| イメージのスキャン | OSのパッケージなど | ビルド直後、保管先 |
| IaCスキャン | クラウドの定義ファイル | マージ前 |
コンテナイメージのスキャンは、ソースコードのスキャンでは見えない部品を調べます。具体的には、ベースイメージ(土台にする既成のイメージ)から入ったOSのパッケージは、自社のリポジトリにソースが無く、SASTの対象になりません。そのため、コードとは別にイメージのスキャンを置きます。
マージ前に動かすスキャン
マージ前に動かすスキャンの役目は、変更がメインのブランチに入る前に問題を見つけることです。GitLabでは、ブランチにプッシュするとスキャナーが動き、開発者は、本番環境に届く前に脆弱性を確かめて直せます。
米国のNISTは『DevSecOpsのCI/CDパイプラインにソフトウェアサプライチェーンのセキュリティを組み込む戦略』(SP 800-204D)で、スキャンにかかわる要件を別々の節に書いています。
要件は、マージ前の依存関係の確認、ビルド直後のイメージのスキャン、社内の保管先での再スキャン、配備時のスキャンの証拠の4つです。
資料はこれらを1か所にまとめてはいないので、この記事で4つを拾い、コミットから配備までの流れの順に並べると次の図のようになります。
4つのうち、ビルド直後と保管先の2つがコンテナイメージを調べる位置です。保管先でもスキャンし直すのは、同じ資料が、社内の保管先にある成果物を新しく見つかった欠陥について調べ直すよう求めているためです。
資料は配備時の証拠の要件で、スキャナーが使う脆弱性の情報は絶えず更新されるので、実行した時期が新しい結果ほど正確だとも書いています。
つまり、マージ前に一度通ったイメージでも、その後に公表された脆弱性は、その時点の結果には出ません。
NISTは『アプリケーションコンテナのセキュリティガイド』(SP 800-190)で、ビルド時に最新だった部品にも、いずれ脆弱性が見つかると説明しています。コンテナは稼働中に部品を更新せず、イメージを作り直して配備し直すので、古いイメージから起動したコンテナはその脆弱性を抱えたまま動きます。
部品の問題が後から公表された例に、圧縮ツールのxz Utilsがあります。Red Hatは2024年3月29日、xzのバージョン5.6.0と5.6.1に、不正なアクセスを許すことを意図したとみられる悪意のあるコードが含まれていると発表しました。
Red Hatはこの問題をCVE-2024-3094とし、Fedora Rawhideの利用者には利用をすぐ止めるよう、Fedora 40の利用者には念のため5.4系へ戻すよう求めました。こうした公表は、イメージのビルド後に届きます。そのため、レジストリに置いたイメージも定期的にスキャンし直します。
置く位置が決まったら、次はイメージのスキャンを実際に有効にする設定です。
コンテナイメージの脆弱性スキャンの入れ方
コンテナイメージの脆弱性スキャンを入れるには、CIのジョブでビルド直後に動かす方法と、イメージを置くレジストリで動かす方法があります。CIのジョブで変更ごとに調べ、レジストリで公表後の脆弱性を拾うように、2つを組み合わせます。
以下では、CIのジョブとしてGitLabのコンテナスキャンとTrivyを、レジストリのスキャンとしてAmazon ECRを取り上げます。
GitLabのコンテナスキャン
GitLabでコンテナイメージを調べるときは、組み込みのTrivyでイメージを解析するコンテナスキャンを使います。説明書「コンテナスキャン」によると、ベースイメージとOSのパッケージの脆弱性を見つけ、直せる場合は直し方も示します。
有効にするには、.gitlab-ci.yml にGitLabが用意したテンプレート(Jobs/Container-Scanning.gitlab-ci.yml)を読み込みます。調べるイメージは、CI/CDの変数 CS_IMAGE で指定します。
前提は、.gitlab-ci.yml に test のステージがあることと、調べるイメージをプロジェクトのコンテナレジストリにプッシュしてあることの2つです。
設定で読み違えやすいのは、言語のパッケージの扱いです。既定では、言語ごとのパッケージは結果に含まれません。変数 CS_DISABLE_LANGUAGE_VULNERABILITY_SCAN を "false" にすると、OS以外のパッケージも報告されます。
アプリケーションが取り込んだライブラリを依存関係スキャンで調べていない場合は、この変数を切り替え、イメージに入ったライブラリもコンテナスキャンの結果に出るようにします。
変数 CS_SEVERITY_THRESHOLD は、指定した重大度以上の脆弱性だけを出力させる設定で、既定は UNKNOWN(全部を出す)です。サポートが終了したOSは、しきい値に関係なく報告されます。
このしきい値は結果の表示を絞る設定で、マージは止めません。マージを止めるのは、最後の章で扱う承認ポリシーです。
結果の見え方は、契約しているプランで変わります。この記事で扱うGitLabの機能を、プランごとに並べると次の表のようになります。
| 機能 | Free・Premium | Ultimate |
|---|---|---|
| JSONのレポートとSBOM |
|
|
| マージリクエストでの表示 |
|
|
| 脆弱性の許可リスト |
|
|
| レジストリのスキャン |
|
|
| マージリクエスト承認ポリシー |
|
|
FreeとPremiumでも、JSON形式のレポートとCycloneDX形式のSBOM(部品表)はジョブの成果物として受け取れます。マージを止める仕組みまで使うなら、Ultimateかどうかを先に確かめます。
Ultimateのレジストリのコンテナスキャンでは、latest タグの付いたイメージをプッシュすると、スキャンのジョブが自動で動き、結果が脆弱性レポートに出ます。ただし、脆弱な部品を更新・削除しても、結果は自動では解決済みになりません。直したら、脆弱性レポートで状態を変えます。
Amazon ECRの基本スキャンと拡張スキャン
Amazon ECRにイメージを置いているなら、まずレジストリで基本スキャンと拡張スキャンのどちらが有効かを確かめます。ECRの説明書によると、2つは調べるパッケージとスキャンの頻度が違います。
基本スキャンは、AWSの仕組みでOSのパッケージだけを調べます。プッシュ時にスキャンするリポジトリはフィルターで指定し、一致しないリポジトリは手動スキャンになります。サポートが終了したOSの結果は、参考情報として扱います。
拡張スキャンは、AWSの脆弱性管理サービスであるAmazon Inspectorと連携し、OSのパッケージと言語のパッケージの両方を調べます。継続スキャンでは、新しい脆弱性が公表されると、既にあるイメージの結果も更新されます。
最初の章で触れた、ビルド後に公表される脆弱性を拾うのはこの継続スキャンです。拡張スキャンにECRの追加料金は無く、Amazon Inspectorの料金がかかります。
ただし、拡張スキャンを最初に有効にしたとき、Amazon Inspectorが認識するのは過去14日間にプッシュされたイメージだけです。スキャンフィルターに一致しないリポジトリもスキャンされません。
フィルターは継続スキャン用とプッシュ時のスキャン用に分けて設定するので、プッシュ時のフィルターだけに一致したリポジトリは、継続しては調べられません。稼働中のイメージが対象に入っているかは、次の2点で確かめます。
14日より前にプッシュしたイメージは、プッシュし直すまで結果が出ません。拡張スキャンでは手動スキャンもできないので、稼働中のイメージのプッシュ日と継続スキャンのフィルターを有効にした直後に確かめます。
拡張スキャンは、EKSやECSでそのイメージが最後に使われた日時や、使っているクラスターの数も示します。
切り替えにも注意が要ります。ECRの説明書によると、基本と拡張を切り替えると、それまでのスキャンの設定は使えなくなり、設定し直す必要があります。
GitLab以外のCIでのTrivyの組み込み
GitHub ActionsなどGitLab以外のCIでは、ビルドの直後にTrivyでイメージを調べるジョブを置く方法があります。Trivyの trivy image コマンドの説明書には、CIに組み込むときに使う次のオプションがあります。
--severity:表示する重大度(UNKNOWN・LOW・MEDIUM・HIGH・CRITICAL)。既定は全部--exit-code:問題が見つかったときの終了コード--ignore-unfixed:修正バージョンが出ている脆弱性だけを表示する--ignorefile:除外する脆弱性を書いたファイル。既定は.trivyignore--format:出力の形式。SARIFやCycloneDXなど
--severity で重大度を絞り、--exit-code に0以外の値を指定すると、対象の重大度の脆弱性が見つかったときにジョブを失敗させられます。CIはジョブの失敗をパイプラインの失敗として扱うので、これが変更を止める仕組みになります。
ビルドの直後に置くジョブでは、たとえば次のように指定します。<イメージ名> には、直前のジョブでビルドしたイメージを指定します。
trivy image --severity HIGH,CRITICAL --ignore-unfixed --exit-code 1 <イメージ名>このコマンドで、見つかった脆弱性がどう扱われるかを分けると次の図のようになります。
--ignore-unfixed を付けると、修正バージョンの無い脆弱性は結果に出ないので、それではジョブは失敗しません。そうした脆弱性をどう扱うかは、最後の章で決めます。
結果をSARIFで出せば、GitHubのコード スキャンに取り込み、他のツールの結果と同じ画面で見られます。
イメージのスキャンが動いたら、次はそのイメージを動かすクラウドの構成を調べます。
定義ファイル(IaC)のスキャン
定義ファイル(IaC)のスキャンで調べるのは、TerraformやCloudFormationで書いたクラウドの構成で、適用する前に規則と照らします。IaC(Infrastructure as Code)は、ネットワークや権限などのクラウドのリソースをファイルに書いて作る方法です。
構成の誤りはイメージのスキャンでは見つからないので、定義ファイルは別に調べます。イメージのスキャンが調べる範囲と、残る構成の誤りを分けると次の図のようになります。
NISTのSP 800-190も、イメージについて、安全な設定に沿っているかを検証するツールと手順を取り入れるよう求めています。例に挙げているのは、特権の無い利用者で動かす設定です。
この要求はイメージの設定についてのもので、クラウドの構成には触れていません。ただし、クラウドの構成も定義ファイルに書いてあれば、同じように適用する前に規則と照らせます。
GitLabの説明書「Infrastructure as Codeスキャン」によると、IaCスキャンはOSSのKICSでTerraform、CloudFormation、Kubernetes、Dockerfileなどの定義ファイルを調べます。
.gitlab-ci.yml にテンプレート(Jobs/SAST-IaC.gitlab-ci.yml)を読み込むと有効になります。スキャン自体はFreeから使えますが、マージリクエストでの結果の表示と、承認の仕組みでの利用はUltimateの機能です。
GitLabのIaCスキャンでは、Ultimateであれば、ルールを無効にしたり、ファイルの先頭に1行書いてそのファイルを丸ごと飛ばしたりできます。ただし、ファイルを飛ばす指定が効くのは一部の形式のファイルだけです。
ルールを無効にする設定ファイル(.gitlab/sast-ruleset.toml)を既定のブランチにマージすると、そのルールで見つかっていた既存の結果は自動で解決済みになります。そのため、無効にする前に、誰がどの理由で外すのかを決めておきます。
イメージと定義ファイルのスキャンが動くようになったら、最後に、どの結果でマージを止めるかを決めます。
脆弱性の重大度でマージを止める基準
マージを止める基準は、どのスキャナーの、どの重大度の、どの状態の脆弱性を対象にするかで決めます。NISTのSP 800-190も、ビルドと配備の各段階に関門を設けるよう求めています。
SP 800-190が例に挙げるのは、CVSS(共通脆弱性評価システム)の点数でしきい値を超える脆弱性を含むイメージを止める規則です。組織の方針を満たすイメージだけを先へ進めるためです。
GitLabでは、マージリクエスト承認ポリシーでこの基準を設定します。説明書によると、セキュリティスキャンの結果を使う規則(scan_finding)では、主に次の項目を指定します。
scanners:対象にするスキャナー(コンテナスキャン、IaCスキャンなど)severity_levels:対象にする重大度vulnerabilities_allowed:規則が働くまでに許す脆弱性の数vulnerability_states:対象にする脆弱性の状態(新しく検出されたもの、以前からあるもの)branches:規則を当てる保護ブランチapprovals_required:必要な承認の数
この承認ポリシーはUltimateで使える機能です。条件に当たったマージリクエストは、指定した数の承認を得るまでマージできません。承認を求める形なので、誰を承認者にするかも一緒に決めます。
基準の分かれ目になるのは、脆弱性の状態です。GitLabの説明書は、マージリクエストのブランチにだけあり、マージ先に無い脆弱性を「新しく検出された」ものとしています。既定のブランチで以前に見つかっていたものは「以前からある」ものです。
新しく検出されたものだけを対象にすると、その変更で持ち込んだ脆弱性では止まり、変更と無関係な既存の脆弱性では止まりません。そのため、以前からある脆弱性は、マージの基準とは別に脆弱性レポートで追います。
スキャナーが動かなかったときの扱いも確かめます。GitLabでは、規則が指定したスキャナーのレポートが無い場合や、そのスキャナーがプロジェクトで有効になっていない場合、脆弱性を持ち込む危険を抑えるために承認が求められます。
無効な規則や当てられない規則の扱いは fallback_behavior で決め、既定は承認を求める側(closed)です。評価は、正常に終わったパイプラインの結果に基づきます。新しく検出されたものを対象にした規則で、マージリクエストがどう分かれるかを並べると次の図のようになります。
重大度の値は、スキャナーごとに出どころが違います。たとえばAmazon ECRの基本スキャンは、配布元のOS(ディストリビューション)の評価を使い、それが無ければCVSSの点数を使います。
Trivyは、ユーザーガイドによると、OSの配布元などデータ元の重大度をNVD(米国の脆弱性データベース)の評価より優先し、データ元に重大度が無ければCVSSの点数から決めます。同じ脆弱性でも出どころで重大度が変わりうるので、基準には、どのスキャナーの重大度で判断するかまで書きます。
GitHubでは、ルールセットのブランチの保護で、コード スキャンの結果を必須にできます。ツールを選び、アラートの重大度(エラー、エラーと警告など)とセキュリティの重大度(重大、高以上、中以上など)のしきい値を選ぶと、チェックに失敗したプルリクエストのマージを止められます。
マージの基準で止めなかった以前からある脆弱性は、脆弱性レポートに残り続けます。一度に全部を直せないときは、実際に悪用されているか、修正バージョンが出ているか、稼働中のイメージに入っているかの3点で直す順番を決めます。
Trivyの結果には、入っているバージョン(INSTALLED VERSION)と修正されたバージョン(FIXED VERSION)が並びます。修正バージョンが空のものは、配布元がまだ修正を出していないものか、修正しない方針(will_not_fix)などのものです。
RHELなど一部の配布元では、Trivyの結果の状態(Status)で、まだ修正が無いもの(affected)と修正しない方針のもの(will_not_fix)を区別できます。
稼働中かどうかは、Amazon ECRの拡張スキャンなら、イメージが最後に使われた日時と、使っているクラスターの数で分かります。
悪用の有無は、米国のCISAが公開する悪用が確認された脆弱性の一覧(KEVカタログ)で確かめます。CISAは、このカタログを脆弱性管理の優先順位付けに使うよう組織に勧めています。カタログの多くの項目には、米国の連邦政府機関に向けた対応として、対策が無ければその製品の利用をやめるよう書かれています。
稼働中のイメージに入っている脆弱性を、KEVカタログに載っているかと修正バージョンの有無で分けると次の図のようになります。
| KEV | 修正バージョン | 扱い |
|---|---|---|
| 載っている | 問わない | 最初に扱う(修正が無ければ部品を外す) |
| 載っていない | 出ている | 作り直して配備し直す |
| 載っていない | 無い | 除外し、理由と見直す時期を残す |
KEVカタログに載っているものは、修正バージョンの有無にかかわらず最初に扱います。修正バージョンがあれば作り直し、無ければベースイメージや部品を替えて、その部品をイメージから外す対処を考えます。CISAがカタログを優先順位付けに使うよう勧めているからです。
そのほかは、修正バージョンが出ていて、稼働中のイメージに入っているものから直します。というのも、修正バージョンの無い脆弱性はイメージを作り直しても消えず、使われていないイメージを直しても、動いている環境は変わらないからです。
Amazon ECRの説明書も、イメージが最後に使われた日時などの情報は、実際に使われているイメージの修復の優先順位を決めるのに役立つとしています。
修正バージョンが出ているものは、ベースイメージや部品を新しいバージョンに上げてイメージを作り直し、配備し直します。最初の章で触れたとおり、コンテナは稼働中に部品を更新しないからです。
SP 800-190は、ベースイメージ(イメージの土台になる層)を信頼できる配布元のものに限り、頻繁に更新し、攻撃される面を減らすために最小限の構成のものを選ぶよう勧めています。
KEVカタログに載っておらず、修正バージョンも無いものを除外のファイル(Trivyの .trivyignore など)に入れるときは、なぜ外したかと、いつ見直すかをファイルの中か変更の説明に残します。
理由が残っていないと、後から見直す人がその脆弱性が本当に影響しないのかを判断できず、配布元が修正を出した後も除外されたままになるからです。
見直しの時期には結果の状態を確かめ、修正が出ていれば作り直し、修正しない方針と分かったもの(RHELの will_not_fix など)はベースイメージや部品の入れ替えを検討します。
コンテナイメージの脆弱性スキャンは、ビルド直後のスキャンとレジストリの継続スキャンを組み合わせてCI/CDに入れ、新しく持ち込んだ脆弱性は規則でマージを止め、以前からあるものは順番を付けて直します。
まずは、レジストリで基本と拡張のどちらのスキャンが有効かと、契約中のプランで承認の規則が使えるかを確かめ、止める重大度と承認者を決めます。



よくある質問
コンテナイメージの脆弱性をすべて直せないときは、どこまで直せばよいですか?
マージを止める基準は、その変更で新しく検出された脆弱性に絞ります。以前からある脆弱性は脆弱性レポートで追い、CISAのKEVカタログに載っているものを修正バージョンの有無にかかわらず最初に扱います。そのほかは、修正バージョンが出ていて、稼働中のイメージに入っているものから直します。
一度スキャンに通ったコンテナイメージも、スキャンし直す必要がありますか?
必要です。スキャナーが使う脆弱性の情報は絶えず更新され、ビルドの後に公表された脆弱性は、通ったときの結果には出ません。レジストリに置いたイメージも定期的にスキャンし直します。Amazon ECRなら、拡張スキャンの継続スキャンで既にあるイメージの結果も更新されます。
修正バージョンが無い脆弱性は、どう扱えばよいですか?
修正バージョンの無い脆弱性は、イメージを作り直しても消えません。Trivyでは --ignore-unfixed を付けると、ジョブを失敗させる対象から外れます。KEVカタログに載っているものは除外せず、ベースイメージや部品を替えて外す対処を考えます。それ以外を除外のファイル(.trivyignore など)に入れるときは、なぜ外したかと、いつ見直すかを残します。見直しの時期に状態を確かめ、修正が出ていれば直し、修正しない方針と分かったもの(RHELの will_not_fix など)は部品の入れ替えを検討します。
業務アプリ・SaaSの関連記事
記事一覧を見るMicrosoft 365のメールアカウント侵害の調査|最初の操作と不正ログインの影響範囲
Microsoft 365の侵害調査の手順を説明する。アカウントの無効化とセッションの取り消し、転送ルール・同意済みのアプリ・管理ロールの確認、サインインログと監査ログで読まれたメールと送られたメールを特定する方法を扱う。
セキュアコーディング規約の作り方:公式の指針、レビューと機械の検査、部品の更新
セキュアコーディング規約の作り方として、.NET・Java・Webアプリの公式の指針の選び方、項目をコード分析・コードスキャンと人のレビューに振り分ける方法、部品と実行環境の更新、周知と見直しの時期を説明します。
CVD(協調的脆弱性開示)とは?Anthropicが深刻な脆弱性の開示期限を90日から30日に短縮した理由
CVD(協調的脆弱性開示)とは、脆弱性を開発元へ非公開で報告し、公開の時期を調整する手続き。Anthropicが開示期限を90日から30日・45日へ短縮した内容と理由、Project Zeroの段階的な短縮、開発元と利用企業への影響を説明する。
Vite 6.4.4の脆弱性を検証|.envの読み取りは通常の出力に残らない
Viteの脆弱性CVE-2026-118662を、6.4.4と修正後の6.4.5・6.4.6を手元で動かして検証しました。返ったファイルと返らなかったファイル、中身が返った要求が開発サーバーの通常の出力に残らないこと、公開しない初期設定で届く範囲を記録しています。
SASTとSCAの違い・使い分け|自動検査の範囲と異常系・回帰試験
SASTとSCAの違いを、調べる対象(自社のソースコードと取り込んだOSS部品)で説明する。両方で見つけにくい認可の誤りを補う動作試験、除外の記録、redis-pyの事故に学ぶ修正後の回帰試験とSCAの再実行も扱う。
OSSのセキュリティリスクと対策|脆弱性・配布物の改ざん・SBOMによる管理
OSSのセキュリティリスクを、既知の脆弱性と配布物の乗っ取りに分けて解説する。Log4j・xz・Shai-Huludの事例から、間接依存まで含むSBOMの作り方、脆弱性情報と改ざん報告の照合、バージョン固定と更新の承認手順を示す。





