SBOM
Was ist CycloneDX?
CycloneDX ist ein offener Standard für Stücklisten (Bills of Materials), getragen von der OWASP Foundation und von Ecma International als ECMA-424 veröffentlicht. Bekannt ist er vor allem als SBOM-Format: eine maschinenlesbare Liste der Komponenten einer Software, ihrer Abhängigkeiten untereinander und dessen, was über ihre Schwachstellen bekannt ist. Die aktuelle Version ist CycloneDX 1.7, und dasselbe Format beschreibt auch Dienste, Hardware, Kryptografie und Machine-Learning-Modelle.
Aktualisiert am
CycloneDX im Überblick
| Gepflegt von | Dem CycloneDX-Projekt der OWASP Foundation, gemeinsam mit dem Technical Committee 54 (TC54) von Ecma International |
|---|---|
| Standard | ECMA-424. Die 1. Ausgabe (Juni 2024) ist CycloneDX 1.6; die 2. Ausgabe (Dezember 2025) ist CycloneDX 1.7 |
| Aktuelle Version | CycloneDX 1.7, veröffentlicht im Oktober 2025 |
| Kodierungen | JSON, XML und Protocol Buffers |
| Medientyp | application/vnd.cyclonedx+json, mit einem Versionsparameter wie version=1.7 |
| Dateinamen | bom.json, bom.xml, *.cdx.json, *.cdx.xml |
Die erste Version, CycloneDX 1.0, erschien 2018 als sicherheitsorientierte Stückliste. Ecma gründete TC54 für Standards zur Lieferkette im Dezember 2023, und CycloneDX 1.6 wurde im Juni 2024 zu ECMA-424. Die Übersicht der Spezifikation und die ECMA-424-Seite sind die maßgeblichen Referenzen.
Was eine CycloneDX-SBOM enthält
Ein CycloneDX-Dokument ist ein einzelnes Objekt, meist BOM genannt. Nur zwei Felder sind Pflicht: bomFormat (immer
"CycloneDX") und specVersion. Alles andere ist optional, weshalb sich zwei gültige CycloneDX-Dateien
so stark darin unterscheiden können, was sie Ihnen tatsächlich sagen.
| Element | Was es enthält |
|---|---|
metadata |
Wann und wie die BOM erstellt wurde: Zeitstempel, Tools, Autoren, die Lebenszyklusphase und die Komponente, die die BOM beschreibt |
components |
Jede Bibliothek, jedes Framework, jeden Container, jede Datei, Firmware, jedes Gerät oder Modell, mit Version, Kennungen, Hashes und Lizenzen |
services |
Externe Dienste, die die Software aufruft, etwa APIs, mit ihren Endpunkten und Datenflüssen |
dependencies |
Welche Komponente oder welcher Dienst wovon abhängt, sodass sich der Baum rekonstruieren lässt, transitive Ebenen eingeschlossen |
compositions |
Wie vollständig jeder Teil der BOM ist: complete, incomplete, unknown oder not specified |
vulnerabilities |
Bekannte Schwachstellen, ihre Bewertungen und, für VEX, ob und wie sie das Produkt betreffen |
formulation |
Wie das Produkt gebaut wurde: die Workflows, Aufgaben und die Umgebung dahinter |
annotations |
Kommentare und Notizen zu anderen Teilen der BOM, mit Angabe, wer sie wann verfasst hat |
declarations, definitions, citations |
Bestätigungen der Konformität mit Standards, die Standards selbst und die Herkunft von Daten in der BOM |
Das Feld metadata.lifecycles gibt an, wann die BOM erstellt wurde: design, pre-build, build, post-build,
operations, discovery oder decommission. Eine SBOM aus der Build-Phase und ein Scan desselben Produkts nach dem Build können unterschiedliche
Komponenten auflisten, die Phase zählt also, wenn Sie zwei Dateien vergleichen.
CycloneDX-BOM-Typen
Dasselbe Objektmodell deckt mehr als Software ab. Das CycloneDX-Projekt nennt diese Einsatzbereiche:
| Typ | Beschreibt |
|---|---|
| SBOM | Softwarekomponenten und ihre Abhängigkeiten |
| SaaSBOM | Dienste, Endpunkte und Datenflüsse einer gehosteten Anwendung |
| HBOM | Hardwarekomponenten |
| CBOM | Kryptografische Assets: Algorithmen, Schlüssel, Zertifikate und Protokolle |
| ML-BOM | Machine-Learning-Modelle und die Datensätze dahinter |
| OBOM und MBOM | Betriebsumgebungen und die Fertigung eines Produkts |
| VEX, VDR und BOV | Ob eine Schwachstelle ein Produkt betrifft (VEX), den Bericht eines Herstellers über bekannte Schwachstellen (VDR) und eine Stückliste der Schwachstellen |
| CDXA | Bestätigungen, dass ein Produkt einen Standard oder eine Anforderung erfüllt |
Das sind Verwendungen eines Formats, keine eigenen Formate. Ein VEX-Dokument zum Beispiel ist eine CycloneDX-BOM, deren
vulnerabilities-Einträge einen Analysezustand tragen und auf Komponenten in einer SBOM verweisen.
Kennungen: purl, CPE und Hashes
Der Name einer Komponente reicht nicht, um sie einer Schwachstelle zuzuordnen, denn derselbe Name kann in verschiedenen
Ökosystemen unterschiedliche Pakete bezeichnen. CycloneDX-Komponenten tragen dafür Kennungen: eine
Package URL (purl) wie pkg:npm/[email protected], eine CPE, ein SWID-Tag,
OmniBOR- und SWHID-Kennungen sowie kryptografische Hashes. Purl ist die Kennung, über die die meisten Tools Open-Source-Pakete abgleichen,
und sie wurde im Dezember 2025 als ECMA-427 ein eigener Ecma-Standard. Innerhalb des Dokuments kann jedes Element außerdem eine
bom-ref haben, eine lokale ID, über die die Abschnitte dependencies, compositions und vulnerabilities darauf verweisen.
Ein CycloneDX-JSON-Beispiel
Eine kleine, aber vollständige SBOM für eine Anwendung, acme-api, die ein npm-Paket nutzt, debug,
das wiederum von ms abhängt. Sie ist gegen das JSON-Schema von CycloneDX 1.7 gültig.
{
"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"] }
]
}
-
serialNumberundversionidentifizieren diese BOM. Jede neu erzeugte BOM erhält eine neue Seriennummer; wird eine bestehende BOM geändert, behält sie ihre Seriennummer, und ihre Version steigt um eins. -
metadata.componentist das Produkt, das die SBOM beschreibt, und die Wurzel des Abhängigkeitsbaums. -
dependenciesmachtmszu einer transitiven Abhängigkeit: Die Anwendung hat sie nie angefordert,debugschon. Ein leeresdependsOnbesagt, dass die Komponente keine Abhängigkeiten hat. Fehlt eine Komponente im Graphen, sind ihre Abhängigkeiten unbekannt, nicht etwa nicht vorhanden. -
compositionsgibt an, dass der Abhängigkeitsbaum unteracme-apivollständig ist. Ein Tool, das nicht alles sehen konnte, sollte stattdessenincompleteoderunknownangeben, damit ein Leser weiß, dass er ein fehlendes Paket nicht als abwesend behandeln darf.
Eine größere Datei mit Hashes, Lieferanten und einer passenden SPDX-Version derselben Anwendung finden Sie unter SBOM-Beispiele.
So erzeugen Sie eine CycloneDX-SBOM
Es gibt drei Wege, eine zu erstellen, und sie beschreiben Unterschiedliches.
| Methode | Wie sie funktioniert | Was sie übersieht |
|---|---|---|
| Scannen von Manifesten und Lockfiles | Liest package-lock.json, requirements.txt, pom.xml und ähnliche Dateien |
Alles, was außerhalb des Paketmanagers geladen wird, etwa über Installationsskripte, Build-Skripte und Basis-Images |
| Analyse von Image, Dateisystem oder Binärdatei | Untersucht ein fertiges Container-Image, ein Verzeichnis oder eine Binärdatei auf Paketmetadaten und Signaturen | Komponenten, die keine Metadaten hinterlassen, und kompilierten Code, bei dem es raten muss |
| Aufzeichnung während des Builds | Zeichnet auf, was der Build tatsächlich geladen hat, während er läuft | Nur, was der Recorder nicht sehen kann, und ein guter weist das als unvollständig aus |
Kostenlose Tools, die CycloneDX schreiben:
-
cdxgen, ein OWASP-Projekt, für viele Sprachen und Container-Images:
cdxgen -o bom.json. Es schreibt standardmäßig CycloneDX 1.7. -
Die Ökosystem-Plugins von CycloneDX, etwa
@cyclonedx/cyclonedx-npm, cyclonedx-python, das CycloneDX-Maven-Plugin und cyclonedx-gomod, jeweils für einen Paketmanager:npx @cyclonedx/cyclonedx-npm --output-file bom.json. -
Syft von Anchore, für Container-Images und Dateisysteme:
syft <image> -o cyclonedx-json.
Das Tool Center von CycloneDX listet viele weitere. Wie sich diese Ansätze in der Praxis vergleichen, lesen Sie unter Open-Source-SBOM-Generatoren und SBOMs für Docker-Images.
So validieren Sie eine CycloneDX-Datei
Die offizielle CycloneDX CLI prüft eine Datei gegen das Schema ihrer Version:
cyclonedx validate --input-file bom.json --input-version v1_7 --fail-on-errors
Dasselbe Tool konvertiert mit cyclonedx convert zwischen JSON, XML und Protocol Buffers, zwischen Spezifikationsversionen und in SPDX JSON.
Die Schema-Validierung beweist nur, dass die Datei wohlgeformt ist. Ob eine
Komponente fehlt, sagt sie Ihnen nicht. Prüfen Sie dafür den Inhalt anhand einer Liste wie der
Checkliste für SBOM-Qualität.
CycloneDX vs. SPDX
SPDX ist das andere weit verbreitete SBOM-Format, betreut von der Linux Foundation und als ISO/IEC 5962:2021 veröffentlicht. Es ist aus der Lizenz-Compliance entstanden, während CycloneDX von der Sicherheit ausging, weshalb CycloneDX Schwachstellen und VEX im selben Format trägt. Beide beschreiben Komponenten, Kennungen, Lizenzen und Beziehungen, Tools konvertieren zwischen ihnen, und der EU Cyber Resilience Act nennt keines der beiden. Welches Sie erzeugen, hängt meist davon ab, was Ihre Kunden und Tools lesen. Der vollständige Vergleich steht unter CycloneDX vs. SPDX.
Wie CRACI CycloneDX-SBOMs erzeugt
CRACI ist ein GitHub-Actions-Runner, der jedes Paket aufzeichnet, das ein Job während seines Laufs lädt, auf jeder Ebene des Abhängigkeitsbaums und einschließlich Paketen aus CI-Caches. Jede Komponente in der SBOM war also tatsächlich im Build. Jedes Paket trägt seine purl und seine deklarierte Lizenz, und die SBOM jedes Jobs hat einen Vollständigkeitsstatus, der angibt, was der Job nicht sehen konnte. Die SBOM lässt sich als CycloneDX oder SPDX exportieren, mit den transitiven Abhängigkeiten und den in ihren Komponenten gefundenen Schwachstellen, und die API liefert sie als CycloneDX 1.7 JSON. Siehe SBOM-Generierung während des Builds oder SBOM Best Practices.
Wann CRACI nicht die Antwort ist
- Hardware-, Kryptografie- oder Dienst-BOMs. CRACI zeichnet Softwarepakete auf, die ein Build lädt. Eine HBOM, CBOM oder SaaSBOM braucht andere Quellen.
- Builds außerhalb von GitHub Actions. GitHub Actions ist heute das einzige unterstützte CI; weitere CI-Systeme sind auf der Roadmap. Nutzen Sie bis dahin einen Generator wie cdxgen.
- Software, die Sie als Binärdatei erhalten. Wenn Sie sie nicht gebaut haben, können Sie ihren Build nicht aufzeichnen. Fragen Sie den Lieferanten nach einer SBOM, oder nutzen Sie eine Binäranalyse.
CycloneDX: häufig gestellte Fragen
Wofür wird CycloneDX verwendet?
Vor allem für SBOMs: Sie listen die Komponenten einer Software auf, damit Sie Schwachstellen und Lizenzen verfolgen und die Liste mit Kunden teilen können. Dasselbe Format deckt auch VEX, Dienste, Hardware, Kryptografie und Machine-Learning-Modelle ab.
Wer pflegt CycloneDX?
Die OWASP Foundation betreibt das CycloneDX-Projekt, und das Technical Committee 54 von Ecma International veröffentlicht es als Standard ECMA-424.
Was ist die neueste Version von CycloneDX?
CycloneDX 1.7, veröffentlicht im Oktober 2025. Sie ist zugleich die 2. Ausgabe von ECMA-424, erschienen im Dezember 2025. Die 1. Ausgabe entspricht CycloneDX 1.6.
Ist CycloneDX JSON oder XML?
Beides, und auch Protocol Buffers. JSON ist am verbreitetsten, mit dem Medientyp application/vnd.cyclonedx+json und Dateinamen wie bom.json oder name.cdx.json.
Ist CycloneDX besser als SPDX?
Generell ist keines besser. CycloneDX ging von der Sicherheit aus und trägt Schwachstellen und VEX nativ, SPDX von der Lizenz-Compliance und ist ein ISO-Standard. Erzeugen Sie, was Ihre Kunden und Tools lesen; Konverter gibt es in beide Richtungen.
Wie prüfe ich, ob eine CycloneDX-Datei gültig ist?
Führen Sie die offizielle CycloneDX CLI aus: cyclonedx validate --input-file bom.json --fail-on-errors. Sie prüft die Struktur gegen das Schema, nicht, ob eine Komponente fehlt.
CycloneDX direkt aus dem Build
Zeichnen Sie jedes Paket auf, das Ihre GitHub-Actions-Jobs laden, mit einem Vollständigkeitsstatus, und exportieren Sie es als CycloneDX oder SPDX.
Demo buchen