Skip to content

[FEATURE]: Add Support for Declaring Usage Context (CBOM, TM, etc) #670

@stevespringett

Description

@stevespringett

In many security-sensitive applications, it's crucial to understand not just what cryptographic asset is used, but how it is used. For example, an algorithm might be used for legal document signing, authentication/authorization workflows, or encryption at rest.

At present, CycloneDX provides detailed support for cryptographic assets via the cryptoProperties structure. However, it lacks a normative way to specify the usage context of the asset.

Proposed Enhancement

Introduce a new optional field to assert the usage context . This could be an enumeration or free-form string, with examples such as:

- signing-legal-documents
- encryption-at-rest
- authentication
- authorization
- secure-boot

Justification

This information is vital for:

- Security audits and compliance
- Risk analysis and threat modeling
- PQC readiness assessments

This need was discussed in the CycloneDX Cryptography Working Group call on 2025-08-07.

cc: @n1ckl0sk0rtge, @bhess

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions