138% flere rapporterede CVE'er pr. dag i 2026 end sidste år.Nyt: altid aktive Fixboxes. Sårbare afhængigheder, rettet og verificeret.

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"] }
  ]
}
  • serialNumber og version identificerer 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.component er det produkt, SBOM'en beskriver, og roden af afhængighedstræet.
  • dependencies gør ms til en transitiv afhængighed: Applikationen bad aldrig om den, det gjorde debug. En tom dependsOn siger, at komponenten ingen afhængigheder har. At udelade en komponent fra grafen betyder, at dens afhængigheder er ukendte, ikke at den ingen har.
  • compositions angiver, at afhængighedstræet under acme-api er komplet. Et værktøj, der ikke kunne se alt, bør i stedet sige incomplete eller unknown, 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