Basics

What is a CBOM? The cryptographic bill of materials, explained

By SBOMBox SBOM experts · · 4 min read

Short answer: a CBOM (cryptographic bill of materials) is an inventory of the cryptography in a piece of software or a system: which algorithms, key lengths, certificates, protocols and crypto libraries it uses, and where. It extends the SBOM idea from components to cryptographic assets. CycloneDX has supported CBOMs natively since version 1.6. The main driver is post-quantum migration: you cannot replace RSA and elliptic-curve cryptography until you know where they are.

Why CBOMs matter now

What goes in a CBOM

CBOM asset types (CycloneDX 1.6)
Asset typeExamplesKey properties
AlgorithmRSA-2048, ECDSA P-256, AES-256-GCM, ML-KEM-768Primitive (signature, key encapsulation, block cipher, hash), parameter set, mode, NIST quantum security level
CertificateTLS server certificate, code-signing certificateSubject, issuer, validity dates, signature algorithm
ProtocolTLS 1.2, TLS 1.3, SSH, IPsecVersion, cipher suites
Related crypto materialPrivate keys, public keys, secret keys, tokensType, size, state, where it is stored (never the key itself)

Each crypto asset is a component with type cryptographic-asset, linked by dependency relationships to the library or application that uses it. That linkage is what turns a list into something you can act on.

A minimal CBOM example

{
  "bomFormat": "CycloneDX",
  "specVersion": "1.6",
  "version": 1,
  "components": [
    {
      "type": "library",
      "bom-ref": "pkg:generic/openssl@3.0.13",
      "name": "openssl",
      "version": "3.0.13",
      "purl": "pkg:generic/openssl@3.0.13"
    },
    {
      "type": "cryptographic-asset",
      "bom-ref": "crypto/algorithm/rsa-2048",
      "name": "RSA-2048",
      "cryptoProperties": {
        "assetType": "algorithm",
        "algorithmProperties": {
          "primitive": "signature",
          "parameterSetIdentifier": "2048",
          "executionEnvironment": "software-plain-ram",
          "nistQuantumSecurityLevel": 0
        },
        "oid": "1.2.840.113549.1.1.1"
      }
    }
  ],
  "dependencies": [
    { "ref": "pkg:generic/openssl@3.0.13", "provides": ["crypto/algorithm/rsa-2048"] }
  ]
}

The nistQuantumSecurityLevel of 0 is the signal that matters: this asset is not quantum-safe and belongs on the migration list.

How to build a CBOM

CBOM vs SBOM vs AI-BOM

They are the same idea applied to different assets, and CycloneDX can hold all three in one document. An SBOM lists software components; an AI-BOM adds models and datasets; a CBOM adds cryptographic assets. If you are choosing a format, CycloneDX covers all three today; see CycloneDX or SPDX?.

Frequently asked questions

What does CBOM stand for?

Cryptographic bill of materials: an inventory of the cryptographic assets (algorithms, keys, certificates, protocols and crypto libraries) in software or a system.

Is a CBOM part of an SBOM?

It extends one. CycloneDX 1.6 lets a single document contain software components and cryptographic assets, linked by dependencies. You can also keep the CBOM as a separate document.

Why do I need a CBOM for post-quantum migration?

Quantum computers are expected to break RSA and elliptic-curve cryptography. You cannot replace those algorithms until you know where they are used, and a CBOM is that inventory.

Which format supports CBOMs?

CycloneDX, from version 1.6 (2024), with the cryptographic-asset component type and cryptoProperties object.