SBOM
Hvad er CycloneDX?
CycloneDX er en åben standard for styklister (bills of materials), drevet af OWASP Foundation og udgivet af Ecma International som ECMA-424. Den er bedst kendt som SBOM-format: en maskinlæsbar liste over komponenterne i et stykke software, hvordan de afhænger af hinanden, og hvad der vides om deres sårbarheder. Den aktuelle version er CycloneDX 1.7, og det samme format beskriver også tjenester, hardware, kryptografi og machine learning-modeller.
Opdateret
CycloneDX i overblik
| Vedligeholdes af | OWASP Foundations CycloneDX-projekt sammen med Ecma Internationals Technical Committee 54 (TC54) |
|---|---|
| Standard | ECMA-424. 1. udgave (juni 2024) er CycloneDX 1.6; 2. udgave (december 2025) er CycloneDX 1.7 |
| Aktuel version | CycloneDX 1.7, udgivet i oktober 2025 |
| Kodninger | JSON, XML og Protocol Buffers |
| Medietype | application/vnd.cyclonedx+json, med en versionsparameter som version=1.7 |
| Filnavne | bom.json, bom.xml, *.cdx.json, *.cdx.xml |
Den første version, CycloneDX 1.0, kom i 2018 som en sikkerhedsfokuseret stykliste. Ecma oprettede TC54 for standarder til forsyningskæden i december 2023, og CycloneDX 1.6 blev til ECMA-424 i juni 2024. Specifikationsoversigten og ECMA-424-siden er de primære referencer.
Hvad en CycloneDX-SBOM indeholder
Et CycloneDX-dokument er ét objekt, som regel kaldet en BOM. Kun to felter er påkrævede, bomFormat (altid
"CycloneDX") og specVersion. Alt andet er valgfrit, og derfor kan to gyldige CycloneDX-filer
afvige så meget i, hvad de faktisk fortæller dig.
| Element | Hvad det indeholder |
|---|---|
metadata |
Hvornår og hvordan BOM'en blev lavet: tidsstempel, værktøjer, forfattere, livscyklusfasen og den komponent, BOM'en beskriver |
components |
Hvert bibliotek, framework, container, fil, firmware, enhed eller model med version, identifikatorer, hashes og licenser |
services |
Eksterne tjenester, som softwaren kalder, såsom API'er, med deres endpoints og dataflows |
dependencies |
Hvilken komponent eller tjeneste der afhænger af hvilken, så træet kan genopbygges, transitive niveauer inklusive |
compositions |
Hvor komplet hver del af BOM'en er: komplet, ufuldstændig, ukendt eller ikke angivet |
vulnerabilities |
Kendte sårbarheder, deres vurderinger og, for VEX, om og hvordan de påvirker produktet |
formulation |
Hvordan produktet blev bygget: workflows, opgaver og miljøet bag det |
annotations |
Kommentarer og noter knyttet til andre dele af BOM'en, med hvem der lavede dem og hvornår |
declarations, definitions, citations |
Attesteringer af overensstemmelse med standarder, selve standarderne, og hvor data i BOM'en kom fra |
Feltet metadata.lifecycles angiver, hvornår BOM'en blev lavet: design, pre-build, build, post-build,
operations, discovery eller decommission. En SBOM fra build-fasen og en scanning efter buildet af det samme produkt kan
vise forskellige komponenter, så fasen betyder noget, når du sammenligner to filer.
CycloneDX-BOM-typer
Den samme objektmodel dækker mere end software. CycloneDX-projektet angiver disse anvendelser:
| Type | Beskriver |
|---|---|
| SBOM | Softwarekomponenter og deres afhængigheder |
| SaaSBOM | Tjenester, endpoints og dataflows i en hostet applikation |
| HBOM | Hardwarekomponenter |
| CBOM | Kryptografiske aktiver: algoritmer, nøgler, certifikater og protokoller |
| ML-BOM | Machine learning-modeller og datasættene bag dem |
| OBOM og MBOM | Driftsmiljøer og fremstillingen af et produkt |
| VEX, VDR og BOV | Om en sårbarhed påvirker et produkt (VEX), en leverandørs rapport over kendte sårbarheder (VDR) og en stykliste over sårbarheder (BOV) |
| CDXA | Attesteringer af, at et produkt opfylder en standard eller et krav |
Det er anvendelser af ét format, ikke separate formater. Et VEX-dokument er for eksempel en CycloneDX-BOM, hvis
vulnerabilities-poster har en analysestatus og peger på komponenter i en SBOM.
Identifikatorer: purl, CPE og hashes
En komponents navn er ikke nok til at matche den med en sårbarhed, fordi det samme navn kan betyde forskellige pakker i
forskellige økosystemer. CycloneDX-komponenter har identifikatorer til det: en
package URL (purl) som pkg:npm/[email protected], en CPE, et SWID-tag,
OmniBOR- og SWHID-identifikatorer samt kryptografiske hashes. Purl er den, de fleste værktøjer matcher på for open
source-pakker, og den blev sin egen Ecma-standard, ECMA-427, i december 2025. Inde i dokumentet kan hvert element også
have en bom-ref, et lokalt ID, som afsnittene dependencies, compositions og vulnerabilities bruger til at
pege på det.
Et CycloneDX JSON-eksempel
En lille, men komplet SBOM for en applikation, acme-api, der bruger én npm-pakke, debug,
som igen afhænger af ms. Den validerer mod CycloneDX 1.7 JSON-skemaet.
{
"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"] }
]
}
-
serialNumberogversionidentificerer denne BOM. Hver nygenereret BOM får et nyt serienummer; når en eksisterende BOM ændres, beholder den serienummeret, og versionen stiger med én. -
metadata.componenter det produkt, SBOM'en beskriver, og roden af afhængighedstræet. -
dependenciesgørmstil en transitiv afhængighed: Applikationen bad aldrig om den, det gjordedebug. En tomdependsOnsiger, at komponenten ingen afhængigheder har. At udelade en komponent fra grafen betyder, at dens afhængigheder er ukendte, ikke at den ingen har. -
compositionsangiver, at afhængighedstræet underacme-apier komplet. Et værktøj, der ikke kunne se alt, bør i stedet sigeincompleteellerunknown, så en læser ved, at en manglende pakke ikke skal behandles som fraværende.
For en større fil med hashes, leverandører og en tilsvarende SPDX-version af den samme applikation, se SBOM-eksempler.
Sådan genererer du en CycloneDX-SBOM
Der er tre måder at lave en på, og de beskriver forskellige ting.
| Metode | Sådan virker den | Hvad den overser |
|---|---|---|
| Scanning af manifest og lockfile | Læser package-lock.json, requirements.txt, pom.xml og lignende filer |
Alt, der hentes uden om pakkehåndteringen, såsom installationsscripts, build-scripts og base-images |
| Analyse af image, filsystem eller binærfil | Undersøger et færdigt container-image, en mappe eller en binærfil for pakkemetadata og signaturer | Komponenter uden efterladte metadata og kompileret kode, den må gætte sig til |
| Registrering under buildet | Registrerer, hvad buildet faktisk hentede, mens det kører | Kun det, registreringen ikke kan se, hvilket en god registrering angiver som ufuldstændigt |
Gratis værktøjer, der skriver CycloneDX:
-
cdxgen, et OWASP-projekt, til mange sprog og container-images:
cdxgen -o bom.json. Det skriver som standard CycloneDX 1.7. -
CycloneDX-økosystemets plugins, såsom
@cyclonedx/cyclonedx-npm, cyclonedx-python, CycloneDX Maven-pluginet og cyclonedx-gomod, hver til én pakkehåndtering:npx @cyclonedx/cyclonedx-npm --output-file bom.json. -
Syft fra Anchore til container-images og filsystemer:
syft <image> -o cyclonedx-json.
CycloneDX' Tool Center viser mange flere. For hvordan tilgangene klarer sig i praksis, se open source SBOM-generatorer og SBOM'er for Docker-images.
Sådan validerer du en CycloneDX-fil
Den officielle CycloneDX CLI tjekker en fil mod skemaet for dens version:
cyclonedx validate --input-file bom.json --input-version v1_7 --fail-on-errors
Det samme værktøj konverterer mellem JSON, XML og Protocol Buffers, mellem specifikationsversioner og til SPDX JSON med
cyclonedx convert. Skemavalidering beviser kun, at filen er velformet. Den kan ikke fortælle dig, om en
komponent mangler. Til det skal du tjekke indholdet mod en liste som
tjeklisten for SBOM-kvalitet.
CycloneDX vs. SPDX
SPDX er det andet udbredte SBOM-format, hostet af Linux Foundation og udgivet som ISO/IEC 5962:2021. Det voksede ud af licensoverholdelse, mens CycloneDX startede med sikkerhed, og derfor rummer CycloneDX sårbarheder og VEX i det samme format. Begge beskriver komponenter, identifikatorer, licenser og relationer, værktøjer konverterer mellem dem, og EU's Cyber Resilience Act nævner ingen af dem. Hvilket du producerer, afhænger som regel af, hvad dine kunder og værktøjer læser. Den fulde sammenligning findes i CycloneDX vs. SPDX.
Sådan producerer CRACI CycloneDX-SBOM'er
CRACI er en GitHub Actions-runner, der registrerer hver pakke, hvert job henter, mens det kører, i alle lag af afhængighedstræet og inklusive pakker gendannet fra CI-caches. Så hver komponent i SBOM'en var faktisk i buildet. Hver pakke har sin purl og deklarerede licens, og hvert jobs SBOM har en fuldstændighedsstatus, der angiver, hvad jobbet ikke kunne se. SBOM'en eksporteres som CycloneDX eller SPDX med de transitive afhængigheder og de sårbarheder, der er fundet i dens komponenter, og API'et returnerer den som CycloneDX 1.7 JSON. Se SBOM-generering under buildet eller best practices for SBOM'er.
Når CRACI ikke er svaret
- Styklister for hardware, kryptografi eller tjenester. CRACI registrerer softwarepakker, som et build henter. En HBOM, CBOM eller SaaSBOM kræver andre kilder.
- Builds uden for GitHub Actions. GitHub Actions er det eneste understøttede CI i dag; andre CI-systemer er på roadmappen. Brug en generator som cdxgen i mellemtiden.
- Software, du modtager som binærfil. Har du ikke bygget den, kan du ikke registrere dens build. Bed leverandøren om en SBOM, eller brug binæranalyse.
CycloneDX: ofte stillede spørgsmål
Hvad bruges CycloneDX til?
Mest til SBOM'er: at liste komponenterne i et stykke software, så du kan spore sårbarheder og licenser og dele listen med kunder. Det samme format dækker også VEX, tjenester, hardware, kryptografi og machine learning-modeller.
Hvem vedligeholder CycloneDX?
OWASP Foundation driver CycloneDX-projektet, og Ecma Internationals Technical Committee 54 udgiver det som standarden ECMA-424.
Hvad er den nyeste version af CycloneDX?
CycloneDX 1.7, udgivet i oktober 2025. Den er også 2. udgave af ECMA-424, udgivet i december 2025. 1. udgave svarer til CycloneDX 1.6.
Er CycloneDX JSON eller XML?
Begge dele, og også Protocol Buffers. JSON er det mest almindelige, med medietypen application/vnd.cyclonedx+json og filnavne som bom.json eller name.cdx.json.
Er CycloneDX bedre end SPDX?
Ingen af dem er generelt bedre. CycloneDX startede med sikkerhed og rummer sårbarheder og VEX direkte, SPDX med licensoverholdelse og er en ISO-standard. Producér det, dine kunder og værktøjer læser; der findes konvertere i begge retninger.
Hvordan tjekker jeg, at en CycloneDX-fil er gyldig?
Kør den officielle CycloneDX CLI: cyclonedx validate --input-file bom.json --fail-on-errors. Den tjekker strukturen mod skemaet, ikke om en komponent mangler.
CycloneDX direkte fra buildet
Registrér hver pakke, dine GitHub Actions-jobs henter, med en fuldstændighedsstatus, og eksportér det som CycloneDX eller SPDX.
Book en demo