O 138% więcej zgłoszonych CVE dziennie w 2026 niż przed rokiem.Nowość: zawsze aktywne Fixboxes. Podatne zależności, naprawione i zweryfikowane.

SBOM

Czym jest CycloneDX?

CycloneDX to otwarty standard zestawień komponentów (bill of materials), prowadzony przez OWASP Foundation i opublikowany przez Ecma International jako ECMA-424. Najbardziej znany jest jako format SBOM: czytelna maszynowo lista komponentów oprogramowania, zależności między nimi i tego, co wiadomo o ich podatnościach. Aktualna wersja to CycloneDX 1.7, a ten sam format opisuje też usługi, sprzęt, kryptografię i modele uczenia maszynowego.

Zaktualizowano

CycloneDX w skrócie

Utrzymywany przez Projekt CycloneDX w OWASP Foundation wraz z Komitetem Technicznym 54 (TC54) Ecma International
Standard ECMA-424. Wydanie 1. (czerwiec 2024) to CycloneDX 1.6; wydanie 2. (grudzień 2025) to CycloneDX 1.7
Aktualna wersja CycloneDX 1.7, wydana w październiku 2025
Kodowania JSON, XML i Protocol Buffers
Typ mediów application/vnd.cyclonedx+json, z parametrem wersji, takim jak version=1.7
Nazwy plików bom.json, bom.xml, *.cdx.json, *.cdx.xml

Pierwsza wersja, CycloneDX 1.0, ukazała się w 2018 r. jako zestawienie komponentów nastawione na bezpieczeństwo. W grudniu 2023 r. Ecma powołała TC54 do standardów łańcucha dostaw, a w czerwcu 2024 r. CycloneDX 1.6 stał się standardem ECMA-424. Podstawowymi źródłami są przegląd specyfikacji oraz strona ECMA-424.

Co zawiera SBOM CycloneDX

Dokument CycloneDX to jeden obiekt, zwykle nazywany BOM. Wymagane są tylko dwa pola: bomFormat (zawsze "CycloneDX") i specVersion. Wszystko inne jest opcjonalne, dlatego dwa poprawne pliki CycloneDX mogą tak bardzo różnić się tym, co faktycznie mówią.

Element Co zawiera
metadata Kiedy i jak powstał BOM: znacznik czasu, narzędzia, autorzy, faza cyklu życia oraz komponent, który BOM opisuje
components Każda biblioteka, framework, kontener, plik, firmware, urządzenie lub model, z wersją, identyfikatorami, hashami i licencjami
services Usługi zewnętrzne wywoływane przez oprogramowanie, takie jak API, z ich endpointami i przepływami danych
dependencies Który komponent lub usługa zależy od którego, aby można było odtworzyć drzewo, łącznie z poziomami przechodnimi
compositions Na ile kompletna jest każda część BOM: complete, incomplete, unknown lub not specified
vulnerabilities Znane podatności, ich oceny oraz, w przypadku VEX, czy i jak wpływają na produkt
formulation Jak zbudowano produkt: stojące za nim workflow, zadania i środowisko
annotations Komentarze i notatki dołączone do innych części BOM, z informacją, kto i kiedy je dodał
declarations, definitions, citations Atestacje zgodności ze standardami, same standardy oraz pochodzenie danych w BOM

Pole metadata.lifecycles mówi, kiedy powstał BOM: design, pre-build, build, post-build, operations, discovery lub decommission. SBOM z fazy buildu i skan tego samego produktu po buildzie mogą wymieniać różne komponenty, więc faza ma znaczenie przy porównywaniu dwóch plików.

Typy BOM w CycloneDX

Ten sam model obiektowy obejmuje więcej niż oprogramowanie. Projekt CycloneDX wymienia następujące możliwości:

Typ Opisuje
SBOM Komponenty oprogramowania i ich zależności
SaaSBOM Usługi, endpointy i przepływy danych hostowanej aplikacji
HBOM Komponenty sprzętowe
CBOM Zasoby kryptograficzne: algorytmy, klucze, certyfikaty i protokoły
ML-BOM Modele uczenia maszynowego i stojące za nimi zbiory danych
OBOM i MBOM Środowiska operacyjne oraz produkcja wyrobu
VEX, VDR i BOV Czy podatność dotyczy produktu (VEX), raport dostawcy o znanych podatnościach (VDR) oraz zestawienie podatności (BOV)
CDXA Atestacje, że produkt spełnia standard lub wymaganie

To zastosowania jednego formatu, a nie odrębne formaty. Dokument VEX to na przykład BOM CycloneDX, którego wpisy vulnerabilities zawierają stan analizy i wskazują komponenty w SBOM.

Identyfikatory: purl, CPE i hashe

Sama nazwa komponentu nie wystarcza, by dopasować go do podatności, ponieważ ta sama nazwa może oznaczać różne pakiety w różnych ekosystemach. Do tego służą identyfikatory w komponentach CycloneDX: package URL (purl), taki jak pkg:npm/[email protected], CPE, tag SWID, identyfikatory OmniBOR i SWHID oraz hashe kryptograficzne. Purl to identyfikator, po którym większość narzędzi dopasowuje pakiety open source, a w grudniu 2025 r. stał się osobnym standardem Ecma, ECMA-427. Wewnątrz dokumentu każdy element może też mieć bom-ref, lokalny identyfikator, którym wskazują go sekcje dependencies, compositions i vulnerabilities.

Przykład CycloneDX w JSON

Mały, ale kompletny SBOM aplikacji acme-api, która używa jednego pakietu npm, debug, który z kolei zależy od ms. Przechodzi walidację względem schematu JSON CycloneDX 1.7.

{
  "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 i version identyfikują ten BOM. Każdy nowo wygenerowany BOM otrzymuje nowy numer seryjny; gdy istniejący BOM jest modyfikowany, zachowuje numer seryjny, a jego wersja rośnie o jeden.
  • metadata.component to produkt, który opisuje SBOM, i korzeń drzewa zależności.
  • dependencies czyni ms zależnością przechodnią: aplikacja nigdy o nią nie prosiła, zrobił to debug. Pusta tablica dependsOn oznacza, że komponent nie ma zależności. Pominięcie komponentu w grafie oznacza, że jego zależności są nieznane, a nie że ich nie ma.
  • compositions stwierdza, że drzewo zależności pod acme-api jest kompletne. Narzędzie, które nie widziało wszystkiego, powinno zamiast tego podać incomplete lub unknown, aby czytelnik wiedział, że brakującego pakietu nie należy traktować jako nieobecnego.

Większy plik z hashami, dostawcami i odpowiadającą mu wersją SPDX tej samej aplikacji zawiera strona przykłady SBOM.

Jak wygenerować SBOM CycloneDX

Są trzy sposoby, a każdy z nich opisuje coś innego.

Metoda Jak działa Czego nie widzi
Skanowanie manifestów i lockfile Odczytuje package-lock.json, requirements.txt, pom.xml i podobne pliki Niczego, co pobrano poza menedżerem pakietów, na przykład przez skrypty instalacyjne, skrypty buildu i obrazy bazowe
Analiza obrazu, systemu plików lub pliku binarnego Przeszukuje gotowy obraz kontenera, katalog lub plik binarny pod kątem metadanych i sygnatur pakietów Komponentów, po których nie zostały metadane, oraz skompilowanego kodu, którego zawartość musi zgadywać
Rejestrowanie w trakcie buildu Rejestruje to, co build faktycznie pobrał, w trakcie jego działania Tylko tego, czego rejestrator nie widzi, a dobry rejestrator oznacza to jako niekompletne

Bezpłatne narzędzia zapisujące CycloneDX:

  • cdxgen, projekt OWASP, dla wielu języków i obrazów kontenerów: cdxgen -o bom.json. Domyślnie zapisuje CycloneDX 1.7.
  • Wtyczki ekosystemowe CycloneDX, takie jak @cyclonedx/cyclonedx-npm, cyclonedx-python, wtyczka CycloneDX dla Maven i cyclonedx-gomod, każda dla jednego menedżera pakietów: npx @cyclonedx/cyclonedx-npm --output-file bom.json.
  • Syft firmy Anchore, dla obrazów kontenerów i systemów plików: syft <image> -o cyclonedx-json.

Tool Center CycloneDX wymienia znacznie więcej. Jak te podejścia wypadają w praktyce, opisują strony generatory SBOM open source i SBOM-y obrazów Docker.

Jak zwalidować plik CycloneDX

Oficjalne CycloneDX CLI sprawdza plik względem schematu jego wersji:

cyclonedx validate --input-file bom.json --input-version v1_7 --fail-on-errors

To samo narzędzie konwertuje między JSON, XML i Protocol Buffers, między wersjami specyfikacji oraz do SPDX JSON, poleceniem cyclonedx convert. Walidacja względem schematu dowodzi tylko, że plik jest poprawnie zbudowany. Nie powie, czy brakuje jakiegoś komponentu. Do tego trzeba sprawdzić treść według listy, takiej jak checklista jakości SBOM.

CycloneDX vs SPDX

SPDX to drugi powszechnie używany format SBOM, prowadzony przez Linux Foundation i opublikowany jako ISO/IEC 5962:2021. Wyrósł z zarządzania zgodnością licencyjną, podczas gdy CycloneDX zaczynał od bezpieczeństwa, dlatego CycloneDX przenosi podatności i VEX w tym samym formacie. Oba opisują komponenty, identyfikatory, licencje i relacje, narzędzia konwertują między nimi, a Cyber Resilience Act UE nie wskazuje żadnego z nich. To, który Państwo tworzą, zależy zwykle od tego, co odczytują Państwa klienci i narzędzia. Pełne porównanie zawiera strona CycloneDX vs SPDX.

Jak CRACI tworzy SBOM-y CycloneDX

CRACI to runner GitHub Actions, który rejestruje każdy pakiet pobrany przez każde zadanie w trakcie jego działania, na każdym poziomie drzewa zależności, łącznie z pakietami przywróconymi z cache CI. Każdy komponent w SBOM faktycznie był więc w buildzie. Każdy pakiet ma swój purl i deklarowaną licencję, a SBOM każdego zadania ma stan kompletności, który mówi, czego zadanie nie mogło zobaczyć. SBOM eksportuje się jako CycloneDX lub SPDX, z zależnościami przechodnimi i podatnościami znalezionymi w jego komponentach, a API zwraca go jako CycloneDX 1.7 JSON. Zob. generowanie SBOM w czasie buildu lub dobre praktyki SBOM.

Kiedy CRACI nie jest odpowiedzią

  • BOM-y sprzętu, kryptografii lub usług. CRACI rejestruje pakiety oprogramowania pobierane przez build. HBOM, CBOM lub SaaSBOM wymagają innych źródeł.
  • Buildy poza GitHub Actions. GitHub Actions to dziś jedyny obsługiwany system CI; inne systemy CI są w planach rozwoju. W międzyczasie warto użyć generatora takiego jak cdxgen.
  • Oprogramowanie otrzymywane jako plik binarny. Jeśli nie zbudowali go Państwo sami, nie można zarejestrować jego buildu. Proszę poprosić dostawcę o SBOM lub użyć analizy plików binarnych.

CycloneDX: najczęściej zadawane pytania

Do czego służy CycloneDX?

Głównie do SBOM: wymieniania komponentów oprogramowania, aby śledzić podatności i licencje oraz udostępniać listę klientom. Ten sam format obejmuje też VEX, usługi, sprzęt, kryptografię i modele uczenia maszynowego.

Kto utrzymuje CycloneDX?

Projekt CycloneDX prowadzi OWASP Foundation, a Komitet Techniczny 54 Ecma International publikuje go jako standard ECMA-424.

Jaka jest najnowsza wersja CycloneDX?

CycloneDX 1.7, wydana w październiku 2025 r. Jest to też 2. wydanie ECMA-424, opublikowane w grudniu 2025 r. Wydanie 1. odpowiada CycloneDX 1.6.

Czy CycloneDX to JSON czy XML?

Jedno i drugie, a do tego Protocol Buffers. Najczęściej używany jest JSON, z typem mediów application/vnd.cyclonedx+json i nazwami plików takimi jak bom.json lub nazwa.cdx.json.

Czy CycloneDX jest lepszy od SPDX?

Ogólnie żaden nie jest lepszy. CycloneDX zaczynał od bezpieczeństwa i natywnie przenosi podatności oraz VEX, SPDX wyrósł ze zgodności licencyjnej i jest standardem ISO. Warto tworzyć to, co odczytują Państwa klienci i narzędzia; konwertery istnieją w obu kierunkach.

Jak sprawdzić, czy plik CycloneDX jest poprawny?

Należy uruchomić oficjalne CycloneDX CLI: cyclonedx validate --input-file bom.json --fail-on-errors. Sprawdza ono strukturę względem schematu, a nie to, czy brakuje jakiegoś komponentu.

CycloneDX prosto z buildu

Proszę rejestrować każdy pakiet pobierany przez zadania GitHub Actions, ze stanem kompletności, i eksportować go jako CycloneDX lub SPDX.

Umów demo