SBOM CI Config Generator
Pick your CI system and options, and copy a working pipeline that generates and checks an SBOM on every build.
Runs in your browser Nothing uploaded No account needed Free
.github/workflows/sbom.yml
name: SBOM
on:
push:
branches: [main]
pull_request:
permissions:
contents: read
id-token: write # keyless sign-in to SBOMBox, no secret needed
jobs:
sbom:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: sbombox/action@v1
with:
project: "<your-project-id>" # your project ID (not a secret)
fail-under: "7"
profiles: cra-readiness
Set up
- Run
sbombox loginand thensbombox initin your repository. It picks the project, trusts this repository for keyless uploads and fills in the project ID. - Commit the file as .github/workflows/sbom.yml.
- Pull requests from forks cannot sign in, so the action skips the upload there and still scores the SBOM.
- The job fails when the score is below 7. The SBOM is uploaded first, so failing runs are recorded too.
Every command and option here comes from the CLI reference and the GitHub Action docs.
How it works
- Pick your CIGitHub Actions, GitLab CI, Jenkins, CircleCI, Azure Pipelines, Bitbucket Pipelines, or any CI with a shell.
- Choose the checksSBOM format, a minimum score, compliance rulesets, and whether to upload each build's SBOM to SBOMBox.
- Copy and commitPaste the config into your repository. Every build then produces, checks and keeps an SBOM.
SBOMBox platform
Keep every build's SBOM, not just the last one.
Upload from CI and SBOMBox keeps each release's SBOM with verified provenance, re-checks it nightly for new vulnerabilities and holds the evidence customers and regulators ask for.
Frequently asked questions
Do I need a secret in GitHub Actions?
No. The SBOMBox action signs in keylessly with the workflow's OIDC token (id-token: write). Other CI systems use an SBOMBOX_TOKEN variable.
Which generators does it use?
The action installs syft, cyclonedx-py and cyclonedx-npm automatically, and cdxgen for Java and Gradle when asked. You can also bring an SBOM you already produce.
Does it work without an SBOMBox account?
Generating and scoring work locally with the CLI. Uploading, history, monitoring and release evidence need a free account.