SBOM
CycloneDXとは?
CycloneDXは部品表のためのオープン標準で、OWASP Foundationが運営し、Ecma InternationalがECMA-424として発行しています。最もよく知られているのはSBOMフォーマットとしての用途です。ソフトウェアに含まれるコンポーネント、それらの依存関係、そして脆弱性について判明していることを、機械可読な形式でまとめた一覧です。現在のバージョンはCycloneDX 1.7で、同じフォーマットでサービス、ハードウェア、暗号、機械学習モデルも記述できます。
更新日
CycloneDXの概要
| メンテナンス | OWASP FoundationのCycloneDXプロジェクトと、Ecma InternationalのTechnical Committee 54(TC54) |
|---|---|
| 標準 | ECMA-424。第1版(2024年6月)はCycloneDX 1.6、第2版(2025年12月)はCycloneDX 1.7 |
| 現在のバージョン | CycloneDX 1.7(2025年10月リリース) |
| エンコーディング | JSON、XML、Protocol Buffers |
| メディアタイプ | application/vnd.cyclonedx+json(version=1.7などのバージョンパラメーター付き) |
| ファイル名 | bom.json、bom.xml、*.cdx.json、*.cdx.xml |
最初のバージョンであるCycloneDX 1.0は、セキュリティに重点を置いた部品表として2018年に登場しました。Ecmaは2023年12月にサプライチェーン標準のためのTC54を設立し、CycloneDX 1.6は2024年6月にECMA-424となりました。 仕様の概要と ECMA-424のページ が一次資料です。
CycloneDX SBOMに含まれるもの
CycloneDXドキュメントは1つのオブジェクトで、通常BOMと呼ばれます。必須のフィールドはbomFormat(常に
"CycloneDX")とspecVersionの2つだけです。それ以外はすべて任意のため、有効なCycloneDXファイル同士でも、実際に伝える内容が大きく異なることがあります。
| 要素 | 保持する内容 |
|---|---|
metadata |
BOMがいつ、どのように作成されたか:タイムスタンプ、ツール、作成者、ライフサイクルフェーズ、BOMが記述するコンポーネント |
components |
各ライブラリ、フレームワーク、コンテナ、ファイル、ファームウェア、デバイス、モデルと、そのバージョン、識別子、ハッシュ、ライセンス |
services |
APIなど、ソフトウェアが呼び出す外部サービスと、そのエンドポイントおよびデータフロー |
dependencies |
どのコンポーネントやサービスがどれに依存しているか。推移的な階層を含め、依存関係ツリーを再構築できます |
compositions |
BOMの各部分がどの程度完全か:complete、incomplete、unknown、または指定なし |
vulnerabilities |
既知の脆弱性とその評価、そしてVEXの場合は、製品に影響するかどうかとその影響の仕方 |
formulation |
製品がどのようにビルドされたか:その背後にあるワークフロー、タスク、環境 |
annotations |
BOMの他の部分に付けられたコメントやメモと、その作成者および作成日時 |
declarations、definitions、citations |
標準への適合の証明、標準そのもの、BOM内のデータの出所 |
metadata.lifecyclesフィールドは、BOMがいつ作成されたかを示します:design、pre-build、build、post-build、operations、discovery、decommissionのいずれかです。同じ製品でも、ビルドフェーズのSBOMとビルド後のスキャンでは記載されるコンポーネントが異なることがあるため、2つのファイルを比較するときはフェーズが重要です。
CycloneDXのBOMの種類
同じオブジェクトモデルで、ソフトウェア以外も扱えます。CycloneDXプロジェクトは次の 機能を挙げています。
| 種類 | 記述対象 |
|---|---|
| SBOM | ソフトウェアコンポーネントとその依存関係 |
| SaaSBOM | ホスト型アプリケーションのサービス、エンドポイント、データフロー |
| HBOM | ハードウェアコンポーネント |
| CBOM | 暗号資産:アルゴリズム、鍵、証明書、プロトコル |
| ML-BOM | 機械学習モデルとその背後にあるデータセット |
| OBOMとMBOM | 運用環境と、製品の製造 |
| VEX、VDR、BOV | 脆弱性が製品に影響するかどうか(VEX)、ベンダーによる既知の脆弱性の報告(VDR)、脆弱性の部品表 |
| CDXA | 製品が標準や要件を満たしていることの証明 |
これらは1つのフォーマットの用途であり、別々のフォーマットではありません。たとえばVEXドキュメントは、vulnerabilitiesのエントリが分析状態を持ち、SBOM内のコンポーネントを参照するCycloneDX BOMです。
識別子:purl、CPE、ハッシュ
同じ名前でもエコシステムによって別のパッケージを指すことがあるため、コンポーネントの名前だけでは脆弱性と照合できません。そのためにCycloneDXのコンポーネントは識別子を持ちます。pkg:npm/[email protected]のような
パッケージURL(purl)、CPE、SWIDタグ、OmniBORとSWHIDの識別子、暗号学的ハッシュです。オープンソースパッケージの照合にほとんどのツールが使うのはpurlで、purlは2025年12月に独自のEcma標準ECMA-427となりました。ドキュメント内では、各要素がbom-refというローカルIDを持つこともでき、dependencies、compositions、vulnerabilitiesの各セクションはこれを使って要素を参照します。
CycloneDX JSONの例
アプリケーションacme-apiの、小さいながらも完全なSBOMです。このアプリケーションは1つのnpmパッケージdebugを使い、それがmsに依存しています。CycloneDX 1.7のJSONスキーマに対して検証に合格します。
{
"bomFormat": "CycloneDX",
"specVersion": "1.7",
"serialNumber": "urn:uuid:3e671687-395b-41f5-a30f-a58921a69b79",
"version": 1,
"metadata": {
"timestamp": "2026-11-16T09:30:00Z",
"lifecycles": [{ "phase": "build" }],
"component": {
"type": "application",
"bom-ref": "acme-api",
"name": "acme-api",
"version": "1.4.0"
}
},
"components": [
{
"type": "library",
"bom-ref": "pkg:npm/[email protected]",
"name": "debug",
"version": "4.4.0",
"purl": "pkg:npm/[email protected]",
"licenses": [{ "license": { "id": "MIT" } }]
},
{
"type": "library",
"bom-ref": "pkg:npm/[email protected]",
"name": "ms",
"version": "2.1.3",
"purl": "pkg:npm/[email protected]",
"licenses": [{ "license": { "id": "MIT" } }]
}
],
"dependencies": [
{ "ref": "acme-api", "dependsOn": ["pkg:npm/[email protected]"] },
{ "ref": "pkg:npm/[email protected]", "dependsOn": ["pkg:npm/[email protected]"] },
{ "ref": "pkg:npm/[email protected]", "dependsOn": [] }
],
"compositions": [
{ "aggregate": "complete", "dependencies": ["acme-api"] }
]
}
-
serialNumberとversionは、このBOMを識別します。新たに生成されるBOMには毎回新しいシリアル番号が付き、既存のBOMを変更した場合はシリアル番号を保ったままバージョンが1つ上がります。 -
metadata.componentは、SBOMが記述する製品であり、依存関係ツリーのルートです。 -
dependenciesによって、msは推移的依存関係になります。アプリケーションが要求したのではなく、debugが要求したものです。空のdependsOnは、そのコンポーネントに依存関係がないことを示します。コンポーネントをグラフから省くと、依存関係がないのではなく、依存関係が不明であることを意味します。 -
compositionsは、acme-api以下の依存関係ツリーが完全であることを示します。すべてを把握できなかったツールは、代わりにincompleteまたはunknownと示すべきです。そうすれば読み手は、記載のないパッケージを存在しないものとして扱ってはいけないとわかります。
ハッシュとサプライヤーを含むより大きなファイルや、同じアプリケーションのSPDX版については、 SBOMの例をご覧ください。
CycloneDX SBOMの生成方法
生成方法は3つあり、それぞれ記述する内容が異なります。
| 方法 | 仕組み | 漏れるもの |
|---|---|---|
| マニフェストとロックファイルのスキャン | package-lock.json、requirements.txt、pom.xmlなどのファイルを読み取る |
インストールスクリプト、ビルドスクリプト、ベースイメージなど、パッケージマネージャー以外で取得されたもの |
| イメージ、ファイルシステム、バイナリの解析 | 完成したコンテナイメージ、ディレクトリ、バイナリを調べ、パッケージのメタデータやシグネチャを探す | メタデータが残っていないコンポーネントや、推測に頼るしかないコンパイル済みコード |
| ビルド時の記録 | ビルドの実行中に、実際に取得したものを記録する | 記録ツールから見えないものだけ。優れたツールはそれをincompleteと明示する |
CycloneDXを出力できる無料ツール:
-
cdxgen:OWASPのプロジェクトで、多くの言語とコンテナイメージに対応します。
cdxgen -o bom.json。デフォルトでCycloneDX 1.7を出力します。 -
CycloneDXのエコシステム別プラグイン:
@cyclonedx/cyclonedx-npm、cyclonedx-python、CycloneDX Mavenプラグイン、cyclonedx-gomodなど、それぞれ1つのパッケージマネージャーに対応します。npx @cyclonedx/cyclonedx-npm --output-file bom.json。 -
Syft:Anchore製で、コンテナイメージとファイルシステムに対応します。
syft <image> -o cyclonedx-json。
CycloneDXのTool Centerには、さらに多くのツールが掲載されています。これらの手法を実際に比較した内容は、オープンソースのSBOM生成ツールと DockerイメージのSBOMをご覧ください。
CycloneDXファイルの検証方法
公式のCycloneDX CLIは、ファイルをそのバージョンのスキーマに対してチェックします。
cyclonedx validate --input-file bom.json --input-version v1_7 --fail-on-errors
同じツールのcyclonedx convertで、JSON、XML、Protocol Buffersの相互変換、仕様バージョン間の変換、SPDX JSONへの変換もできます。スキーマ検証で証明できるのは、ファイルが正しい形式であることだけです。コンポーネントが漏れているかどうかはわかりません。それを確認するには、
SBOM品質チェックリストなどのリストに照らして内容をチェックしてください。
CycloneDXとSPDXの比較
SPDXはもう1つの広く使われているSBOMフォーマットで、Linux Foundationがホストし、ISO/IEC 5962:2021として発行されています。SPDXはライセンスコンプライアンスから発展したのに対し、CycloneDXはセキュリティから始まりました。そのためCycloneDXは、脆弱性とVEXを同じフォーマットで扱えます。どちらもコンポーネント、識別子、ライセンス、関係を記述でき、相互に変換するツールがあり、EUのCyber Resilience Actはどちらも指定していません。どちらを出力するかは、通常、顧客やツールが何を読み取るかで決まります。詳しい比較はCycloneDXとSPDXの比較をご覧ください。
CRACIがCycloneDX SBOMを生成する仕組み
CRACIはGitHub Actionsのランナーで、各ジョブが実行中に取得するすべてのパッケージを、依存関係ツリーのあらゆる階層で、CIキャッシュから復元されたパッケージも含めて記録します。そのため、SBOM内のすべてのコンポーネントは実際にビルドに含まれていたものです。各パッケージにはpurlと宣言ライセンスが付き、各ジョブのSBOMには、そのジョブが把握できなかったものを示す完全性の状態が付与されます。SBOMは推移的依存関係とコンポーネントで見つかった脆弱性を含めてCycloneDXまたはSPDXでエクスポートでき、APIはCycloneDX 1.7 JSONとして返します。 ビルド時のSBOM生成または SBOMのベストプラクティスをご覧ください。
CRACIが適さないケース
- ハードウェア、暗号、サービスのBOM。CRACIが記録するのは、ビルドが取得するソフトウェアパッケージです。HBOM、CBOM、SaaSBOMには別の情報源が必要です。
- GitHub Actions以外でのビルド。現在サポートしているCIはGitHub Actionsのみで、その他のCIシステムはロードマップに掲載されています。それまではcdxgenなどの生成ツールをお使いください。
- バイナリとして受け取るソフトウェア。自社でビルドしていなければ、そのビルドを記録することはできません。サプライヤーにSBOMを求めるか、バイナリ解析を使ってください。
CycloneDX:よくあるご質問
CycloneDXは何に使われますか?
主にSBOMです。ソフトウェアに含まれるコンポーネントを一覧にすることで、脆弱性とライセンスをトラッキングし、その一覧を顧客と共有できます。同じフォーマットで、VEX、サービス、ハードウェア、暗号、機械学習モデルも扱えます。
CycloneDXをメンテナンスしているのは誰ですか?
OWASP FoundationがCycloneDXプロジェクトを運営し、Ecma InternationalのTechnical Committee 54がECMA-424標準として発行しています。
CycloneDXの最新バージョンは何ですか?
2025年10月にリリースされたCycloneDX 1.7です。これは2025年12月に発行されたECMA-424の第2版でもあります。第1版はCycloneDX 1.6に対応します。
CycloneDXはJSONですか、それともXMLですか?
両方に加え、Protocol Buffersにも対応しています。最も一般的なのはJSONで、メディアタイプはapplication/vnd.cyclonedx+json、ファイル名はbom.jsonやname.cdx.jsonなどです。
CycloneDXはSPDXより優れていますか?
一概にどちらが優れているとは言えません。CycloneDXはセキュリティから始まり、脆弱性とVEXをネイティブに扱えます。SPDXはライセンスコンプライアンスから始まり、ISO標準です。顧客やツールが読み取るものを出力しましょう。双方向の変換ツールがあります。
CycloneDXファイルが有効かどうかはどう確認しますか?
公式のCycloneDX CLIを実行します:cyclonedx validate --input-file bom.json --fail-on-errors。これはスキーマに対して構造をチェックするもので、コンポーネントが漏れているかどうかはチェックしません。
ビルドそのものからCycloneDXを
GitHub Actionsのジョブが取得するすべてのパッケージを完全性の状態とともに記録し、CycloneDXまたはSPDXでエクスポートしましょう。
デモを予約