Output Format Reference¶
CycloneDX format specification details.
Supported Formats¶
CBOM Generator outputs CycloneDX format only:
| Format | Specification | CLI Flag |
|---|---|---|
| CycloneDX 1.6 | Default | --cyclonedx-spec 1.6 or omit |
| CycloneDX 1.7 | Latest | --cyclonedx-spec 1.7 |
CycloneDX 1.6 vs 1.7¶
Both versions produce similar content:
| Feature | 1.6 | 1.7 |
|---|---|---|
specVersion |
"1.6" |
"1.7" |
| Schema validation | CycloneDX 1.6 schema | CycloneDX 1.7 schema |
| Tool compatibility | Wider | Growing |
| Dependencies array | Supported | Enhanced |
Recommendation: Use 1.6 for maximum compatibility. Use 1.7 when you need full dependency graph features.
JSON Structure¶
{
"bomFormat": "CycloneDX",
"specVersion": "1.6",
"serialNumber": "urn:uuid:...",
"version": 1,
"metadata": {},
"components": [],
"dependencies": [],
"relationships": []
}
Schema Validation¶
Validate output against CycloneDX schema:
# Using cyclonedx-cli
cyclonedx validate --input cbom.json
# Using ajv
ajv validate -s bom-1.6.schema.json -d cbom.json
Schema files available at: - https://cyclonedx.org/schema/bom-1.6.schema.json - https://cyclonedx.org/schema/bom-1.7.schema.json
CBOM Extensions¶
CBOM Generator uses standard CycloneDX fields plus namespaced properties:
Standard CycloneDX Fields¶
type: Component typename: Component namebom-ref: Unique identifierversion: Version stringcryptoProperties: CBOM crypto details
CBOM Namespaced Properties¶
Properties prefixed with cbom: provide extended detail:
cbom:pqc:*- PQC assessmentcbom:cert:*- Certificate detailscbom:key:*- Key detailscbom:proto:*- Protocol detailscbom:ctx:*- Detection context
Output Determinism¶
With --deterministic (default):
- Component order: Sorted alphabetically
- Property order: Consistent
- Timestamps: Excluded
- Serial number: Content-based UUID
File Size Estimates¶
| Scan Type | Components | File Size |
|---|---|---|
| /etc/ssl/certs only | ~200 | ~500KB |
| System scan | ~500-1000 | ~1-2MB |
| With services | ~500-2000 | ~2-5MB |
| Enterprise | ~5000+ | ~10MB+ |
Use --dedup-mode=strict to reduce size.