shipcra

Was ist eine SBOM? Software-Stückliste einfach erklärt, mit Beispiel

Geprüft am 3 Min. Lesezeit

Eine SBOM (Software Bill of Materials, auf Deutsch Software-Stückliste) ist eine maschinenlesbare Liste der Komponenten einer Software: Namen, Versionen, Lieferanten, Lizenzen und Abhängigkeiten. Der Cyber Resilience Act verpflichtet Hersteller, eine SBOM zu erstellen, die mindestens die obersten Abhängigkeiten abdeckt. Veröffentlichen müssen sie sie nicht.

Das Wichtigste

Bedeutung
Software Bill of Materials, Software-Stückliste
Wichtigste Formate
CycloneDX (ECMA-424) und SPDX (ISO/IEC 5962:2021)
Grundlage im CRA
Anhang I, Teil II, Nummer 1
Mindesttiefe nach CRA
Die obersten Abhängigkeiten
Veröffentlichung
Nicht verpflichtend; auf Anfrage für Marktüberwachungsbehörden
Deutsche Orientierungshilfe
BSI TR-03183 Teil 2 (nicht verbindlich)

Was eine SBOM enthält

Stellen Sie sich die Zutatenliste Ihrer Software vor. Für jede Komponente verzeichnet eine SBOM in der Regel:

  • Name und Version, zum Beispiel react 19.2.0.
  • Eine Kennung, meist eine Package-URL (pkg:npm/react@19.2.0), damit andere Werkzeuge sie mit Schwachstellendatenbanken abgleichen können.
  • Lieferant oder Autor, soweit bekannt.
  • Lizenz, etwa MIT oder Apache-2.0.
  • Beziehungen: welche Komponente von welcher abhängt, um direkte von transitiven Abhängigkeiten zu unterscheiden.
  • Hashwerte, wenn das Werkzeug sie berechnen kann, um zu belegen, welche Datei genau ausgeliefert wurde.

Das Dokument beschreibt außerdem das Produkt selbst (Name, Version, Hersteller) und den Zeitpunkt der Erstellung.

Ein SBOM-Beispiel

Hier ein gekürztes CycloneDX-1.6-Dokument für eine kleine App mit einer einzigen Abhängigkeit:

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.6",
  "serialNumber": "urn:uuid:3e671687-395b-41f5-a30f-a58921a69b79",
  "version": 1,
  "metadata": {
    "timestamp": "2026-11-19T10:00:00Z",
    "component": {
      "type": "application",
      "bom-ref": "lumen-notes@2.4.1",
      "name": "lumen-notes",
      "version": "2.4.1"
    }
  },
  "components": [
    {
      "type": "library",
      "bom-ref": "pkg:npm/react@19.2.0",
      "name": "react",
      "version": "19.2.0",
      "purl": "pkg:npm/react@19.2.0",
      "licenses": [{ "license": { "id": "MIT" } }]
    }
  ],
  "dependencies": [
    { "ref": "lumen-notes@2.4.1", "dependsOn": ["pkg:npm/react@19.2.0"] },
    { "ref": "pkg:npm/react@19.2.0", "dependsOn": [] }
  ]
}

Eine echte App listet Hunderte Komponenten. Die Struktur bleibt gleich.

CycloneDX oder SPDX

CycloneDX SPDX
Gepflegt von OWASP, genormt als ECMA-424 Linux Foundation, genormt als ISO/IEC 5962:2021
Herkunft Anwendungssicherheit Lizenz-Compliance
Übliche Formate JSON, XML JSON, Tag-Value, RDF, YAML
Stärke Abhängigkeiten, Schwachstellen, Dienste Lizenzen, Dateien, Herkunft

Beide erfüllen den CRA. Konverter gibt es in beide Richtungen, die Wahl ist also nicht endgültig.

Was der Cyber Resilience Act verlangt

Anhang I, Teil II, Nummer 1 verlangt von Herstellern, Schwachstellen und Komponenten ihrer Produkte zu ermitteln und zu dokumentieren, unter anderem durch eine Software-Stückliste in einem gängigen, maschinenlesbaren Format, die mindestens die obersten Abhängigkeiten erfasst. Den genauen Wortlaut finden Sie in der deutschen Fassung auf EUR-Lex.

In der Praxis heißt das:

  • Die obersten Abhängigkeiten sind die Untergrenze. Die meisten Werkzeuge listen auch transitive Abhängigkeiten, was den Abgleich mit Schwachstellen deutlich nützlicher macht.
  • Eine SBOM pro Release. Sie muss zu dem passen, was Sie ausgeliefert haben. Erzeugen Sie sie neu, sobald sich die Abhängigkeiten ändern.
  • Aufbewahren, nicht unbedingt veröffentlichen. Sie gehört zur technischen Dokumentation und geht auf Anfrage an die Behörden.

Die Kommission kann Format und Inhalt der SBOM durch Durchführungsrechtsakte näher festlegen. Bis dahin gilt der oben beschriebene Text.

Was die BSI TR-03183 ergänzt

Das Bundesamt für Sicherheit in der Informationstechnik (BSI) hat mit der Technischen Richtlinie TR-03183 eine Orientierungshilfe zum CRA veröffentlicht. Teil 2 behandelt die SBOM: welche Versionen von CycloneDX und SPDX in Frage kommen, welche Felder auf Ebene der SBOM und der einzelnen Komponenten erwartet werden, und eine Abdeckung, die über die obersten Abhängigkeiten hinausgeht. Das BSI pflegt dafür auch eine eigene Taxonomie von CycloneDX-Eigenschaften.

Die Richtlinie ist nicht verbindlich und begründet keine Konformitätsvermutung. Wer seine SBOM danach ausrichtet, hat aber eine solide Grundlage, vor allem wenn Kunden in Deutschland danach fragen.

Was eine SBOM nicht leistet

Eine SBOM ist ein Inventar. Sie beweist nicht, dass ein Produkt sicher ist, und auch nicht, dass es den CRA erfüllt. Sie ist der Ausgangspunkt für die eigentliche Arbeit: Komponenten mit bekannten Schwachstellen abgleichen, entscheiden, was zu beheben ist, und melden, wenn etwas aktiv ausgenutzt wird.

Sie enthält außerdem nur, was das Werkzeug sieht. In das Repository kopierter Code, native Bibliotheken und Engines müssen oft von Hand ergänzt werden. Der praktische Leitfaden, wie Sie eine SBOM aus der Lockfile erstellen, zeigt, wie Sie solche Lücken finden.

Fragen

Ist eine SBOM nach dem Cyber Resilience Act Pflicht?

Ja, für betroffene Produkte ab dem 11. Dezember 2027. Anhang I, Teil II, Nummer 1 verlangt, Komponenten zu ermitteln und zu dokumentieren, unter anderem durch eine Software-Stückliste in einem gängigen, maschinenlesbaren Format, die mindestens die obersten Abhängigkeiten erfasst.

Muss ich meine SBOM veröffentlichen?

Nein. Der CRA verlangt keine Veröffentlichung. Sie bewahren die SBOM mit Ihrer technischen Dokumentation auf und legen sie Marktüberwachungsbehörden auf begründetes Verlangen vor. Wenn Sie sie Nutzern zugänglich machen, verlangt Anhang II die Angabe, wo sie zu finden ist.

CycloneDX oder SPDX?

Beide erfüllen das Kriterium „gängig und maschinenlesbar“. CycloneDX ist sicherheitsorientiert und für Schwachstellendaten gut ausgestattet; SPDX stammt aus der Lizenz-Compliance und ist eine ISO-Norm. Nehmen Sie das Format, das Ihre Werkzeuge erzeugen und Ihre Kunden verlangen.

Was hat die BSI TR-03183 mit der SBOM zu tun?

Teil 2 der Technischen Richtlinie TR-03183 beschreibt, welche Formate, Felder und welche Tiefe eine SBOM aus Sicht des BSI haben sollte. Er geht über das Minimum des CRA hinaus, ist aber nicht verbindlich und begründet keine Konformitätsvermutung.

Quellen

  1. Verordnung (EU) 2024/2847, Anhang I Teil II und Anhang II, EUR-Lex
  2. BSI TR-03183: Cyber Resilience Requirements for Manufacturers and Products
  3. CycloneDX-Spezifikation
  4. SPDX-Spezifikationen

Dieser Leitfaden erklärt die Verordnung allgemein. Er ist keine Rechtsberatung für Ihr Produkt.

Machen Sie aus Ihrer Lockfile eine SBOM.

shipcra liest Ihre Lockfile im Browser und erstellt eine CycloneDX-SBOM für Ihre technische Dokumentation. Die Datei verlässt nie Ihren Rechner.

Frühen Zugang sichern