2026 年每日通報的 CVE 數量比前一年多 138%。全新推出:持續運作的 Fixbox。有漏洞的相依套件,修正並驗證。

SBOM

什麼是 CycloneDX?

CycloneDX 是一項開放的物料清單標準,由 OWASP Foundation 營運,並由 Ecma International 發布為 ECMA-424。它最為人所知的是 SBOM 格式:一份機器可讀的清單,列出某個軟體中的元件、它們彼此的相依關係,以及其漏洞的已知資訊。目前的版本是 CycloneDX 1.7,同一格式也能描述服務、硬體、密碼學資產與機器學習模型。

更新日期

CycloneDX 一覽

維護者 OWASP Foundation 的 CycloneDX 專案,以及 Ecma International 第 54 技術委員會(TC54)
標準 ECMA-424。第 1 版(2024 年 6 月)為 CycloneDX 1.6;第 2 版(2025 年 12 月)為 CycloneDX 1.7
目前版本 CycloneDX 1.7,2025 年 10 月發布
編碼格式 JSON、XML 與 Protocol Buffers
媒體類型 application/vnd.cyclonedx+json,並帶有版本參數,例如 version=1.7
檔案名稱 bom.json、bom.xml、*.cdx.json、*.cdx.xml

第一個版本 CycloneDX 1.0 於 2018 年推出,是一份以資安為重點的物料清單。Ecma 於 2023 年 12 月成立 TC54 負責供應鏈標準,CycloneDX 1.6 則於 2024 年 6 月成為 ECMA-424。 規格概覽與 ECMA-424 頁面 是主要的參考資料。

CycloneDX SBOM 包含哪些內容

CycloneDX 文件是一個物件,通常稱為 BOM。只有兩個欄位是必要的:bomFormat(一律為 "CycloneDX")與 specVersion。其餘都是選用欄位,這也是為什麼兩份同樣有效的 CycloneDX 檔案,實際提供的資訊可能天差地遠。

元素 內容
metadata BOM 的製作時間與方式:時間戳記、工具、作者、生命週期階段,以及該 BOM 所描述的元件
components 每個函式庫、框架、容器、檔案、韌體、裝置或模型,以及其版本、識別碼、雜湊值與授權
services 軟體所呼叫的外部服務(例如 API),以及其端點與資料流
dependencies 哪個元件或服務相依於哪個,讓相依套件樹(包括遞移層級)得以重建
compositions BOM 各部分的完整程度:complete、incomplete、unknown 或 not specified
vulnerabilities 已知漏洞、其評等,以及(就 VEX 而言)它們是否及如何影響產品
formulation 產品的建置方式:其背後的工作流程、任務與環境
annotations 附加在 BOM 其他部分的評論與註記,以及作者與時間
declarations、definitions、citations 符合標準的證明、標準本身,以及 BOM 中資料的來源

metadata.lifecycles 欄位說明 BOM 的製作時機:design、pre-build、build、post-build、operations、discovery 或 decommission。同一產品的建置階段 SBOM 與建置後掃描,可能列出不同的元件,因此比較兩份檔案時,階段很重要。

CycloneDX BOM 類型

同一套物件模型涵蓋的不只是軟體。CycloneDX 專案列出了以下 能力:

類型 描述對象
SBOM 軟體元件及其相依套件
SaaSBOM 託管應用程式的服務、端點與資料流
HBOM 硬體元件
CBOM 密碼學資產:演算法、金鑰、憑證與協定
ML-BOM 機器學習模型及其背後的資料集
OBOM 與 MBOM 營運環境,以及產品的製造
VEX、VDR 與 BOV 漏洞是否影響產品(VEX)、廠商對已知漏洞的報告(VDR),以及漏洞清單(bill of vulnerabilities)
CDXA 產品符合某項標準或要求的證明

這些是同一格式的不同用途,而不是各自獨立的格式。舉例來說,VEX 文件就是一份 CycloneDX BOM,其 vulnerabilities 項目帶有分析狀態,並指向某份 SBOM 中的元件。

識別碼:purl、CPE 與雜湊值

單靠元件名稱不足以將其與漏洞比對,因為同一個名稱在不同生態系中可能代表不同的套件。CycloneDX 元件為此帶有識別碼: package URL(purl),例如 pkg:npm/[email protected]、CPE、SWID 標籤、OmniBOR 與 SWHID 識別碼,以及密碼學雜湊值。對開源套件而言,purl 是多數工具用來比對的識別碼,並已於 2025 年 12 月成為獨立的 Ecma 標準 ECMA-427。在文件內部,每個元素也可以有一個 bom-ref,這是 dependencies、compositions 與 vulnerabilities 區段用來指向它的本地 ID。

CycloneDX JSON 範例

以下是一份小而完整的 SBOM,描述一個應用程式 acme-api:它使用一個 npm 套件 debug,該套件又相依於 ms。這份檔案可通過 CycloneDX 1.7 JSON 結構描述(schema)的驗證。

{
  "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 與 version用來識別這份 BOM。每份新產生的 BOM 都會取得新的序號;修改既有 BOM 時,序號保持不變,版本則加一。
  • metadata.component是 SBOM 所描述的產品,也是相依套件樹的根節點。
  • dependencies讓 ms 成為遞移相依套件:應用程式從未要求它,是 debug 要求的。空的 dependsOn 表示該元件沒有相依套件。若元件未出現在相依關係圖中,則表示其相依套件不明,而不是沒有相依套件。
  • compositions表明 acme-api 之下的相依套件樹是完整的。無法看見全貌的工具應改為標示 incomplete 或 unknown,讓讀者知道不能把遺漏的套件當成不存在。

若想看包含雜湊值、供應商,以及同一應用程式對應 SPDX 版本的較大型檔案,請參閱 SBOM 範例。

如何產生 CycloneDX SBOM

產生方式有三種,而它們描述的是不同的東西。

方法 運作方式 會遺漏什麼
掃描 manifest 與鎖定檔 讀取 package-lock.json、requirements.txt、pom.xml 等檔案 在套件管理工具之外取得的任何內容,例如安裝腳本、建置腳本與基礎映像檔
映像檔、檔案系統或二進位檔分析 檢查完成的容器映像檔、目錄或二進位檔,尋找套件中繼資料與特徵 沒有留下中繼資料的元件,以及必須靠推測的已編譯程式碼
建置時記錄 在建置執行時記錄它實際取得的內容 只有記錄工具看不見的部分,而好的記錄工具會將其標示為不完整

可輸出 CycloneDX 的免費工具:

  • cdxgen:OWASP 專案,支援多種語言與容器映像檔: cdxgen -o bom.json。預設輸出 CycloneDX 1.7。
  • CycloneDX 生態系外掛程式,例如 @cyclonedx/cyclonedx-npm、cyclonedx-python、CycloneDX Maven 外掛程式與 cyclonedx-gomod,各自對應一種套件管理工具: npx @cyclonedx/cyclonedx-npm --output-file bom.json。
  • Syft:Anchore 推出,適用於容器映像檔與檔案系統: syft <image> -o cyclonedx-json。

CycloneDX Tool Center 列出了更多工具。這些做法在實務上的比較,請參閱開源 SBOM 產生工具與 Docker 映像檔 SBOM。

如何驗證 CycloneDX 檔案

官方的 CycloneDX CLI 會依檔案所屬版本的結構描述進行檢查:

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

同一工具也能以 cyclonedx convert 在 JSON、XML 與 Protocol Buffers 之間、在不同規格版本之間轉換,以及轉換為 SPDX JSON。結構描述驗證只能證明檔案格式正確,無法告訴您是否有元件遺漏。若要檢查這點,請依照 SBOM 品質檢查清單等清單檢查內容。

CycloneDX vs SPDX

SPDX 是另一種廣泛使用的 SBOM 格式,由 Linux Foundation 託管,並發布為 ISO/IEC 5962:2021。它源自授權合規,而 CycloneDX 則從資安出發,這也是為什麼 CycloneDX 能在同一格式中承載漏洞與 VEX。兩者都描述元件、識別碼、授權與關聯,有工具可在兩者之間轉換,而歐盟 Cyber Resilience Act 並未指定其中任何一種。要產生哪一種,通常取決於您的客戶與工具讀取哪一種。完整比較請參閱 CycloneDX vs SPDX。

CRACI 如何產生 CycloneDX SBOM

CRACI 是一個 GitHub Actions 執行器,會在每個作業執行時記錄它取得的每個套件,涵蓋相依套件樹的每一層,也包括從 CI 快取還原的套件。因此 SBOM 中的每個元件都確實存在於建置中。每個套件都帶有其 purl 與宣告的授權,每個作業的 SBOM 也都有完整性狀態,說明該作業看不到哪些部分。SBOM 可匯出為 CycloneDX 或 SPDX,並包含遞移相依套件以及在其元件中發現的漏洞;API 則以 CycloneDX 1.7 JSON 格式回傳。請參閱 建置時 SBOM 產生或 SBOM 最佳實務。

CRACI 不適用的情況

  • 硬體、密碼學或服務 BOM。CRACI 記錄的是建置所取得的軟體套件。HBOM、CBOM 或 SaaSBOM 需要其他來源。
  • GitHub Actions 以外的建置。目前僅支援 GitHub Actions 這一種 CI;其他 CI 系統已列入產品藍圖。在此之前,請使用 cdxgen 等產生工具。
  • 以二進位檔形式取得的軟體。如果軟體不是您建置的,您就無法記錄它的建置。請向供應商索取 SBOM,或使用二進位檔分析。

CycloneDX:常見問題

CycloneDX 用來做什麼?

主要用於 SBOM:列出某個軟體中的元件,讓您能追蹤漏洞與授權,並與客戶分享這份清單。同一格式也涵蓋 VEX、服務、硬體、密碼學資產與機器學習模型。

誰負責維護 CycloneDX?

OWASP Foundation 營運 CycloneDX 專案,Ecma International 第 54 技術委員會則將其發布為 ECMA-424 標準。

CycloneDX 的最新版本是什麼?

CycloneDX 1.7,於 2025 年 10 月發布。它也是 ECMA-424 的第 2 版,於 2025 年 12 月發布。第 1 版對應 CycloneDX 1.6。

CycloneDX 是 JSON 還是 XML?

兩者都是,也支援 Protocol Buffers。JSON 最為常見,媒體類型為 application/vnd.cyclonedx+json,檔案名稱如 bom.json 或 name.cdx.json。

CycloneDX 比 SPDX 好嗎?

整體而言沒有優劣之分。CycloneDX 從資安出發,原生支援漏洞與 VEX;SPDX 則源自授權合規,並且是 ISO 標準。請產生您的客戶與工具會讀取的格式;兩個方向都有轉換工具。

如何確認 CycloneDX 檔案是否有效?

執行官方的 CycloneDX CLI:cyclonedx validate --input-file bom.json --fail-on-errors。它會依結構描述檢查檔案結構,但不會檢查是否有元件遺漏。

直接從建置產生 CycloneDX

記錄您的 GitHub Actions 作業取得的每個套件並附上完整性狀態,再匯出為 CycloneDX 或 SPDX。

預約示範