Skip to content

[WIP] CycloneDX v2.0 Specification - #652

Draft
stevespringett wants to merge 520 commits into
masterfrom
2.0-dev
Draft

stevespringett wants to merge 520 commits into
masterfrom
2.0-dev

Conversation

@stevespringett

@stevespringett stevespringett commented Jun 15, 2025 •

Copy link
Copy Markdown
Member

Important

WORK IN PROGRESS
see Milestone for progress: https://github.com/CycloneDX/specification/milestone/2


CycloneDX 2.0 — draft changelog

Breaking changes

  • Renamed bom-ref to refId (#673 per #1113)
  • Renamed bomFormat to specFormat (#775 per #1087)
  • Replaced the implicit inventory structure with explicit inventories and reusable definitions (#1072 per #1075)
  • Consolidated services into components with the service type (#733 per #975)
  • Consolidated component identifiers under identifiers (#935 per #936)
  • Changed formulation environment variables to system-independent key-value pairs (#247, #248, #249 per #1088)
  • Consolidated component and vulnerability evidence into a shared model (#278, #333, #979 per #980)
  • All of the following removals and changes shall be seen as breaking changes!

Added

  • Role-based parties and actors (#718 per #930)
  • Conditional components (#928 per #929)
  • First-class hardware support (#981 per #982)
  • AI/ML support (per #990)
  • Model cards (per #990)
  • Threat-model support (#462 per #678)
  • Blueprint support (#463 per #678)
  • OWASP Threat Model Library support (per #1034)
  • Threat events and persona context (per #1034)
  • Reusable qualitative risk matrices (per #1034)
  • Perspectives (#736 per #745)
  • Risk and safety modeling (#954 per #1120)
  • Vulnerability evidence (#333, #979 per #980)
  • Multiple call stacks (#278 per #980)
  • License and copyright evidence (#979 per #980)
  • Party attribution in evidence (#979 per #980)
  • Cryptographic key-usage properties (#738 per #769)
  • Cryptographic algorithm security properties (#738 per #769)
  • System and process metadata for evidence occurrences (#738 per #769)
  • Cryptographic agility properties (#892 per #947)
  • Cryptographic protocol registry (per #1010)
  • Custom cryptographic fingerprints (per #903)
  • Additional cryptographic functions, paddings, and validation levels (per #841)
  • GMAC and CMAC modes (#780 per #845)
  • The unwrap cryptographic function (#794 per #845)
  • JSS signatures (#851 per #858)
  • EPSS-based vulnerability scoring (#481 per #1117)

Removed

  • Removed Metadata's manufacture; use the root Component's parties with the manufacturer role (#386 per #930)
  • Removed Component's author; use Component parties with the author role (#387 per #930)
  • Removed Metadata's supplier; use the root Component's parties with the supplier role (#345 per #1090)
  • Removed individual role-specific party fields, such as manufacturer and supplier; use parties on the relevant item with the corresponding role (#718 per #930)

Implementation

  • Dropped the XML schema implementation
  • Dropped the Protocol Buffers schema implementation
  • Updated the JSON Schema implementation from draft-07 to 2020-12 (#639)

Docs

  • Updated normative language, schema validation, reference practices, and property descriptions (per #1199, #1208, #1209, #1210)

Draft based on closed issues and merged pull requests in the 2.0 milestone. draft summary generated with AI asitance, until 2.0 is locked


@stevespringett stevespringett added this to the 2.0 milestone Jun 15, 2025
@stevespringett stevespringett self-assigned this Jun 15, 2025
@stevespringett stevespringett added the CDX 2.0 related to release v2.0 label Jun 15, 2025
@stevespringett stevespringett linked an issue Jun 15, 2025 that may be closed by this pull request
@jkowalleck jkowalleck changed the title CycloneDX v2.0 Specification [WIP] CycloneDX v2.0 Specification Jun 16, 2025
@jkowalleck

This comment was marked as outdated.

jkowalleck added a commit that referenced this pull request Aug 4, 2026
merge latest master and fix conflicts


caused by
#652 (comment)
---- 

there are currently some conflicts in the `.github/workflows/*` 
```text
This branch has conflicts that must be resolved

Use the command line to resolve conflicts before continuing.

    .github/workflows/bundle_2.0_schemas.yml
    .github/workflows/test_java.yml
    .github/workflows/test_js.yml
    .github/workflows/test_php.yml
    .github/workflows/test_proto.yml
    docgen/json/templates/cyclonedx/base.html
    docgen/json/templates/cyclonedx/section_properties.html
    docgen/proto/templates/html.tmpl
    docgen/xml/xs3p.xsl
    tools/src/test/js/json-schema-functional-tests.js
    tools/src/test/js/json-schema-lint-tests.js
```


i will sort this out soon.
basically this is a file being moved in our(`2.0-dev`) branch, and a
dependabot updating an action in their's(`master`) branch.
similar with tests and QA tools ... 

but i have no idea what to do with the docs - i guess we use "ours"?

---------

Signed-off-by: wievdndr <wiebe.vandendriessche@ugent.be>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: Basil Hess <bhe@zurich.ibm.com>
Signed-off-by: Mehrn0ush <mehrnoush.vaseghi@gmail.com>
Signed-off-by: Steve Springett <steve@springett.us>
Signed-off-by: Joachim Vandersmissen <git@jvdsn.com>
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: wievdndr <wiebe.vandendriessche@ugent.be>
Co-authored-by: Wiebe Vandendriessche <146532897+wiebe-vandendriessche@users.noreply.github.com>
Co-authored-by: Basil Hess <bhe@zurich.ibm.com>
Co-authored-by: Mehrn0ush <mehrnoush.vaseghi@gmail.com>
Co-authored-by: Steve Springett <steve@springett.us>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Co-authored-by: Joachim Vandersmissen <git@jvdsn.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Comment thread tools/src/main/js/bundler/package.json Resolved
stevespringett and others added 28 commits October 30, 2026 15:17
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Srinivas Chippagiri <cvas22@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
…1084)

Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

breaking-changes CDX 2.0 related to release v2.0 test-data related to test-resources and -data

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CycloneDX 2.0

7 participants