vet
supports CycloneDX v1.6 SBOM generation. The generated SBOM provides a comprehensive inventory of all packages and their dependencies in your project, including security metadata like detected vulnerabilities, malware, and license information.
Quick Start
Generate an SBOM with a custom application name:The
--report-cdx-app-name
parameter is optional. If omitted, vet will use a default application name.What’s Included in the SBOM
The generated CycloneDX SBOM contains comprehensive information about your software supply chain:Package Inventory
Complete list of all direct and transitive dependencies
Vulnerability Data
Known vulnerabilities from OSV database and other sources
License Information
License identifiers and compliance data for each component
Malware Detection
Results from malware analysis and threat detection
Advanced Usage
Custom Application Metadata
Provide detailed metadata about your application:Combined with Other Reports
Generate multiple report formats simultaneously:Integration with CI/CD
Sample SBOMs
Explore example SBOMs to understand the format and content:Chat Server SBOM
Example SBOM for a Node.js chat application
Express.js SBOM
Example SBOM for an Express.js web application
SBOM Analysis and Consumption
Viewing SBOM Content
Use standard CycloneDX tools to analyze your SBOM:Integration with Security Tools
Many security tools can consume CycloneDX SBOMs:- Dependency Track: Import SBOMs for vulnerability monitoring
- FOSSA: License compliance analysis
- Snyk: Security scanning and monitoring
- JFrog Xray: Artifact analysis and security scanning
Policy Enforcement
Use SBOMs with policy engines for compliance:Best Practices
Naming Conventions
Naming Conventions
Use consistent naming patterns for your SBOMs:
Version Control
Version Control
Consider storing SBOMs in version control alongside releases for traceability and historical analysis.
Automation
Automation
Generate SBOMs automatically in your CI/CD pipeline to ensure they stay current with your dependencies.
Signed SBOMs
Signed SBOMs
Sign your SBOMs for integrity verification:
Compliance and Standards
NTIA Minimum Elements
The generated SBOMs include all NTIA minimum elements:- Data Fields: Supplier name, component name, version, unique identifier, dependency relationships, author of SBOM data, timestamp
- Automation Support: Machine-readable format with well-defined schema
- Practices and Processes: Consistent generation methodology
Executive Order 14028
SBOMs generated by vet help organizations comply with Executive Order 14028 requirements for software supply chain security.Troubleshooting
Large SBOM Files
Large SBOM Files
For projects with many dependencies, SBOMs can become large. Consider:
- Filtering out development dependencies in production SBOMs
- Using compressed storage formats
- Implementing SBOM splitting for microservices
Missing Components
Missing Components
If components are missing from your SBOM:
- Ensure all package manifest files are included in the scan
- Check that vet supports your package manager
- Verify dependencies are properly declared in manifest files
Validation Errors
Validation Errors
If SBOM validation fails:
- Check the CycloneDX schema version compatibility
- Verify all required fields are present
- Use cyclonedx-cli for detailed validation errors