SBOM erstellen in der CI/CD-Pipeline: Syft, Trivy, cdxgen
Stand 5 Min. Lesezeit
Eine SBOM, die von Hand gepflegt wird, ist nach dem nächsten Release veraltet. Erzeugen Sie sie deshalb im Build – mit bewährten freien Werkzeugen, die es für fast jede Umgebung gibt, vom Web-Backend bis zur Firmware. Diese Anleitung zeigt, welches Werkzeug wozu passt und wie die SBOM danach automatisch geprüft wird.
Warum im Build
Anhang I Teil II Nr. 1 verlangt, Schwachstellen und Komponenten zu ermitteln und zu dokumentieren, unter anderem durch eine SBOM in einem gängigen maschinenlesbaren Format, die mindestens die obersten Abhängigkeiten abdeckt. Die Pflicht gilt ab dem 11. Dezember 2027. Die Meldepflicht nach Art. 14 gilt schon seit dem 11. September 2026 – und eine aktuelle SBOM je Version ist das schnellste Mittel, um bei einer aktiv ausgenutzten Schwachstelle zu wissen, welche Produkte betroffen sind.
- Die SBOM passt genau zum ausgelieferten Stand, weil sie aus demselben Build entsteht.
- Jede Version bekommt ihre eigene SBOM – wichtig, wenn ältere Versionen noch im Einsatz und im Unterstützungszeitraum sind.
- Niemand muss daran denken: Der Build erzeugt und übergibt sie bei jedem Release.
Quelle: Anhang I Teil II Nr. 1 CRA · Art. 14 CRA · Art. 71 Abs. 2 CRA
Welches Werkzeug wofür
- Syft (Anchore, Apache-2.0): liest Verzeichnisse, Container-Images und Archive und erkennt unter anderem Pakete von Alpine, Debian und RPM sowie Go, Python, Java, JavaScript, Ruby, Rust, PHP und .NET. Gibt CycloneDX und SPDX aus. Guter Standard für Software und Container.
- Trivy (Aqua Security, Apache-2.0): eigentlich ein Sicherheitsscanner, erzeugt aber auch SBOMs aus Verzeichnissen und Container-Images, als CycloneDX (JSON) und SPDX. Praktisch, wenn Trivy schon in der Pipeline läuft.
- cdxgen (CycloneDX-Projekt, Apache-2.0, npm-Paket @cdxgen/cdxgen): viele Sprachen und Paketmanager, für C und C++ mit dem mitgelieferten Werkzeug atom. Erzeugt standardmäßig CycloneDX 1.7.
- Zephyr: „west spdx“ erzeugt nach dem Build SPDX-Dokumente (Standard SPDX 2.3) für Anwendung, Zephyr, Build-Ergebnis und Modulabhängigkeiten. Voraussetzung ist CONFIG_BUILD_OUTPUT_META im Projekt.
- Yocto: Die Klasse create-spdx ist standardmäßig aktiv und legt für jedes Image eine SPDX-Datei im Deploy-Verzeichnis ab. Seit Yocto 5.1 (Styhead) ist das SPDX 3.0.
Nebrino liest CycloneDX 1.4 bis 1.7 (JSON oder XML), SPDX 2.2 und 2.3 (JSON oder Tag-Value) und SPDX 3.0 im JSON-LD-Format – etwa aus Yocto ab 5.1. Aus SPDX 3.0 übernimmt Nebrino Pakete mit Version, Paket-URL, CPE und Lizenz sowie die Abhängigkeitsbeziehungen.
Für den Abgleich mit Schwachstellendatenbanken braucht jede Komponente eine Paket-URL (purl) oder eine CPE mit Version. Die Werkzeuge oben geben Paket-URLs aus, soweit sie die Pakete erkennen. Was sie nicht erkennen – etwa einkopierte Bibliotheken in Firmware –, ergänzen Sie von Hand.
Dependency-Track (OWASP, Open Source) erzeugt selbst keine SBOM: Die Plattform erfasst vorhandene Stücklisten, sucht darin nach Schwachstellen und setzt Richtlinien durch. Sie ist also keine Alternative zu den Werkzeugen oben, sondern kommt danach.
Quelle: Syft (GitHub) · cdxgen (GitHub) · Zephyr: west spdx (englisch) · Yocto: SBOM erzeugen (englisch) · sbom-cve-check: SPDX 3.0 seit Yocto 5.1 (englisch) · Trivy: SBOM (englisch) · Dependency-Track (englisch)
Schritt 1: SBOM erzeugen
syft scan dir:. -o cyclonedx-json=sbom.cdx.jsontrivy fs --format cyclonedx --output sbom.cdx.json .cdxgen -o sbom.cdx.json .west build -d build
west spdx -d build
# Ergebnis: build/spdx/app.spdx, zephyr.spdx, build.spdx, modules-deps.spdxQuelle: Syft (GitHub) · cdxgen (GitHub) · Zephyr: west spdx (englisch)
Schritt 2: Hochladen und prüfen lassen
Nebrino nimmt die SBOM über die API entgegen, legt die Version an, gleicht die Komponenten mit OSV, NVD, dem CISA-KEV-Katalog und der europäischen Schwachstellendatenbank EUVD ab und meldet das Ergebnis direkt an die Pipeline zurück. Das API-Token liegt dabei nur im Secret-Speicher Ihrer CI. Die API gehört zum Paket Professional und ist in der Testphase enthalten.
curl -sS --fail-with-body \
-H "Authorization: Bearer $NEBRINO_TOKEN" \
-F "sbom=@sbom.cdx.json" \
-F "product=$NEBRINO_PRODUCT_ID" \
-F "version=1.4.2" \
-F "fail_on=exploited" \
https://app.nebrino.de/api/v1/sbom \
| jq -e '.failed == false' # Exit-Code 1, wenn das Gate auslöstSehr große SBOMs gleicht Nebrino im Hintergrund ab; die Antwort enthält dann eine Status-Adresse statt des Ergebnisses. Fertige Vorlagen für GitHub Actions, GitLab CI, Azure DevOps, Jenkins und ein allgemeines Shell-Skript – mit Warten auf den Hintergrundabgleich, Wiederholungen bei Netzwerkfehlern, verständlichen Fehlermeldungen und Zusammenfassung im Build-Protokoll – finden Sie in Nebrino unter Einstellungen → API und CI/CD, vorausgefüllt mit Ihrer Produkt-ID.
Quelle: Anhang I Teil II Nr. 1, 2 CRA
Sie nutzen schon Dependency-Track?
Dann muss die Pipeline nichts doppelt erzeugen: Holen Sie die SBOM eines Projekts aus Dependency-Track und laden Sie sie wie in Schritt 2 hoch. Dependency-Track bleibt Ihr Werkzeug für Richtlinien und Analyse im Team, Nebrino übernimmt Fristen, Meldungen nach Art. 14 und die Nachweise für den Cyber Resilience Act. Exportieren Sie die reine Stückliste (Variante „inventory“) – den Abgleich mit OSV, NVD, CISA KEV und EUVD macht Nebrino selbst.
# Projekt-UUID über Name und Version ermitteln
UUID=$(curl -sS --fail-with-body -H "X-Api-Key: $DT_API_KEY" \
"$DT_URL/api/v1/project/lookup?name=gateway-firmware&version=1.4.2" | jq -r .uuid)
# SBOM als CycloneDX-JSON exportieren (Inventar, ohne Schwachstellen)
curl -sS --fail-with-body -H "X-Api-Key: $DT_API_KEY" \
"$DT_URL/api/v1/bom/cyclonedx/project/$UUID?format=json&variant=inventory" \
-o sbom.cdx.jsonBeide Aufrufe brauchen in Dependency-Track nur das Recht VIEW_PORTFOLIO. Ab Version 5.2 legen Sie dafür am besten ein eigenes Service-Konto mit eigenem Schlüssel an, statt einen Team-Schlüssel mitzunutzen. Den Export im Format CycloneDX 1.5 (Standard von Dependency-Track) liest Nebrino direkt; danach folgt der Upload aus Schritt 2 mit derselben Versionsnummer.
Quelle: Dependency-Track: REST-API v1 (englisch) · Dependency-Track: Dateiformate und Export (englisch) · Dependency-Track: Zugriffsrechte und Service-Konten (englisch)
Schritt 3: Release stoppen, wenn es brennt
Mit dem Parameter fail_on entscheidet die Antwort der API, ob der Build weiterlaufen darf:
- none – nie stoppen, nur hochladen und berichten;
- exploited – stoppen, wenn eine offene Schwachstelle aktiv ausgenutzt wird (CISA KEV oder EUVD);
- critical – zusätzlich stoppen bei offenen kritischen Schwachstellen.
Offen heißt: noch nicht als „nicht betroffen“ oder „behoben“ bewertet (VEX). Ist eine Komponente zwar verwundbar, die Lücke im Produkt aber nicht ausnutzbar, halten Sie das in Nebrino mit Begründung fest – dann läuft der Build wieder durch, und die Begründung steht in der Dokumentation.
Anhang I Teil I Nr. 2 Buchst. a verlangt, Produkte ohne bekannte ausnutzbare Schwachstellen bereitzustellen (ab 11.12.2027). Ein Gate im Build ist eine einfache Möglichkeit, das bei jedem Release zu prüfen.
Qualität der SBOM: BSI TR-03183-2
Die Technische Richtlinie TR-03183-2 des BSI (Version 2.1.0) beschreibt, welche Angaben eine SBOM enthalten soll – unter anderem CycloneDX ab 1.6 oder SPDX ab 3.0.1, Ersteller und Zeitstempel, je Komponente Lizenz, SHA-512-Hash und Angaben zu ausführbaren Dateien, Archiven und Struktur. Sie ist nicht verbindlich, aber eine gute Orientierung.
Die meisten Werkzeuge erfüllen das nicht vollständig ohne Nacharbeit. Nebrino zeigt bei jedem Upload einer CycloneDX-SBOM im JSON-Format oder einer SPDX-3.0-SBOM (JSON-LD), welche Pflichtangaben der Richtlinie fehlen und bei wie vielen Komponenten.
Quelle: BSI TR-03183
Checkliste
- Werkzeug passend zum Projekt wählen und die Version im Build fest vorgeben, damit die SBOM reproduzierbar bleibt.
- SBOM bei jedem Release-Tag erzeugen – und für Container-Images aus dem fertigen Image, nicht nur aus dem Quellcode.
- Die Version aus dem Git-Tag übernehmen, damit SBOM und ausgelieferter Stand zusammenpassen.
- Mit fail_on=exploited beginnen; critical erst einschalten, wenn die offenen Befunde bewertet sind.
- Fehlende Komponenten (einkopierte Bibliotheken, Binärdateien von Zulieferern) ergänzen und in Nebrino prüfen, welche Komponenten abgleichbar sind.
Weitere Ratgeber zum Thema
Begriffe im Glossar zum Cyber Resilience Act
Quellen
- Verordnung (EU) 2024/2847, Art. 14, 71, Anhang I (EUR-Lex, Amtsblatt)
- Syft – SBOM-Generator von Anchore (GitHub)
- cdxgen – SBOM-Generator des CycloneDX-Projekts (GitHub)
- Zephyr Project: west spdx (englisch)
- Yocto Project: Creating a Software Bill of Materials (englisch)
- BSI: Technische Richtlinie TR-03183
Erstveröffentlichung 23.10.2026, Stand 17.11.2026. Dieser Ratgeber gibt den Wortlaut der Verordnung und die Leitlinien der Kommission wieder und ersetzt keine Rechtsberatung.