Skip to content

cdxgen/cdxgen-plugins-bin

Repository files navigation

Introduction

This repo contains binary executables that could be invoked by cdxgen.

SBOM NPM NPM Downloads

Usage

Installation

Install cdxgen, which installs this plugin as an optional dependency.

sudo npm install -g @cyclonedx/cdxgen

cdxgen would automatically use the plugins from the global node_modules path to enrich the SBOM output for certain project types such as docker.

Bundled helpers

The published packages currently bundle helper binaries such as:

  • trivy-cdxgen-* for container/rootfs OS package inventory
  • osqueryi-* for live-host OBOM collection
  • sourcekitten and dosai for Swift/.NET enrichment
  • trustinspector-cdxgen-* for deep trust inspection of repository keyrings, CA stores, macOS code-sign/notarization state, and Windows Authenticode / WDAC policy inventory

Plugin manifest + provenance bundle

Each packaged plugins/ directory now includes:

  • sbom-postbuild.cdx.json — a post-build CycloneDX inventory of the bundled helpers
  • plugins-manifest.json — a lightweight provenance bundle containing the generated-at timestamp, package identity, and per-plugin component metadata (purl, version, hash, binary path, and merged SBOM reference)

cdxgen reads plugins-manifest.json automatically when present so the generated BOM can record more precise helper-tool identity/version data under metadata.tools.

The manifest is data only. cdxgen does not execute commands, scripts, or paths from it; the file is parsed as JSON and used only to tighten helper provenance in metadata.tools.

CI coverage

The main test workflow now includes an explicit Windows smoke path that verifies:

  • build.ps1 stages trustinspector-cdxgen-windows-amd64.exe
  • plugins/plugins-manifest.json is generated on Windows and includes trustinspector
  • trustinspector host returns Windows host findings
  • trustinspector paths <signed binary> returns Authenticode properties on the runner

About

Binary plugins for @cyclonedx/cdxgen npm package

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors