138% mehr gemeldete CVEs pro Tag in 2026 als im Vorjahr.Neu: immer aktive Fixboxes. Verwundbare Abhängigkeiten, behoben und verifiziert.

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"] }
  ]
}
  • serialNumber und version identifizieren 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.component ist das Produkt, das die SBOM beschreibt, und die Wurzel des Abhängigkeitsbaums.
  • dependencies macht ms zu einer transitiven Abhängigkeit: Die Anwendung hat sie nie angefordert, debug schon. Ein leeres dependsOn besagt, dass die Komponente keine Abhängigkeiten hat. Fehlt eine Komponente im Graphen, sind ihre Abhängigkeiten unbekannt, nicht etwa nicht vorhanden.
  • compositions gibt an, dass der Abhängigkeitsbaum unter acme-api vollständig ist. Ein Tool, das nicht alles sehen konnte, sollte stattdessen incomplete oder unknown angeben, 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