Integrate the CycloneDX Ruby gem with Vulnesis. Generate a CycloneDX SBOM from your Ruby Bundler project and upload to Vulnesis.
Install & scan
$ gem install cyclonedx-ruby $ cyclonedx-ruby --path . --output bom.json --format JSON
Run CycloneDX Ruby Gem in CI
Scan on every push and upload the report as a workflow artifact:
- name: Set up Ruby
uses: ruby/setup-ruby@v1
with:
ruby-version: '3.3'
bundler-cache: true
- name: Install CycloneDX Ruby gem
run: gem install cyclonedx-ruby
- name: Generate CycloneDX SBOM
run: cyclonedx-ruby --path . --output bom.json --format JSON
- name: Upload report
uses: actions/upload-artifact@v6
with:
name: cyclonedx-ruby
path: bom.json
if-no-files-found: warnThen one publish job hands every artifact in the run to Vulnesis, recorded under CycloneDX Ruby Gem's own name and version. Written once per workflow, however many scanners you run:
publish:
name: Publish to Vulnesis
runs-on: ubuntu-latest
needs: [scan] # every scanner job, or its report is never published
if: always() # or one failing scanner suppresses all the others
permissions:
contents: read
actions: read # required to list the run's artifacts
env:
VULNETIX_ORG_ID: ${{ secrets.VULNETIX_ORG_ID }}
VULNETIX_API_KEY: ${{ secrets.VULNETIX_API_KEY }}
steps:
- uses: actions/checkout@v5
- name: Install Vulnesis CLI
run: |
curl -fsSL https://cli.vulnes.is/install.sh | sh -s -- --install-dir "$HOME/.local/bin"
echo "$HOME/.local/bin" >> "$GITHUB_PATH"
- name: Publish scanner reports
env:
GITHUB_TOKEN: ${{ github.token }}
run: vulnetix gha upload --org-id "$VULNETIX_ORG_ID" --jsonAfter the run, vulnetix gha status reports what was actually recorded.
How Vulnesis compares: better together
Vulnesis does not replace CycloneDX Ruby Gem. Keep running it. Vulnesis sits on top of CycloneDX Ruby Gem (and every other scanner you already own) turning disconnected tool outputs into one prioritised, fixable queue.
CycloneDX Ruby Gem is strongest at its core category and also carries features in License Compliance, SCA, just as Vulnesis spans categories.
| Capability | Vulnesis | CycloneDX Ruby Gem |
|---|---|---|
| Security coverage | ||
| SAST (static code analysis) | ✓ Built-in rules + Semgrep augmentation | ✗ |
| SCA / dependencies | ✓ 40+ ecosystems, transitive graph | ~ Enumerates all resolved transitive gems from Gemfile.lock; no vulnerability scanning itself |
| DAST (dynamic testing) | ~ Ingests DAST results; no native dynamic engine | ✗ |
| Container & image | ✓ Image CVEs, base image, Dockerfile | ✗ |
| IaC / misconfiguration | ✓ Terraform, k8s, CloudFormation | ✗ |
| Secret scanning | ✓ 1,000+ rules, source + binary + git history | ✗ |
| Cloud / CSPM | ✓ Cloud-posture findings, compliance tab | ✗ |
| Mobile (MAST) | ~ Ingests mobile scanner output; no native mobile engine | ✗ |
| License compliance | ✓ SPDX, copyleft/AGPL/SSPL policy | ~ Fetches gemspec metadata including license fields; no license-policy enforcement |
| SBOM generation | ✓ CycloneDX 1.7 + SPDX 2.3, cosign-signable | ✓ Core: valid CycloneDX (XML/JSON, spec 1.1-1.7) from Gemfile.lock resolved gems |
| Malware / supply-chain | ✓ De-duplicated corpus + install-time firewall (25 registries) | ✗ |
| Network / infra vuln | ~ Ingests network scanner output; no native network scanner | ✗ |
| Fuzzing | ✗ Ingests fuzzing crashes; no native fuzzer | ✗ |
| Pentest / bug bounty | ✗ Ingests pentest/bug-bounty findings; not a testing service | ✗ |
| The Vulnesis orchestration layer | ||
| Cross-scanner dedup & one queue (ASPM) | ✓ Correlates every scanner into one prioritised queue with ownership routing | ✗ |
| Exploit-intel prioritisation | ✓ EPSS, CISA KEV, Coalition ESS, CWSS, Vulnesis LEV | ✗ |
| Reachability analysis | ✓ Tree-sitter + CVEAffected; direct/transitive/semantic | ✗ |
| Versioned VEX + audit trail | ✓ Immutable OpenVEX/CycloneDX, cosign-signable | ✗ |
| Safe Harbour autofix | ✓ Resolves + applies the nearest safe version | ✗ |
| End-of-life policy | ✓ Flags/blocks past-EOL runtimes & packages | ✗ |
| SSVC / risk-based policy | ✓ SSVC v2 + CISA/FedRAMP/Essential-8 presets | ✗ |
✓ full · ~ partial · ✗ not covered
What CycloneDX Ruby Gem does well
- Official CycloneDX SBOM generator for Ruby/Bundler, reading Gemfile.lock as the authoritative record of resolved gems including transitive dependencies
- Broad current CycloneDX spec coverage (1.1 through 1.7, default 1.7) in both XML and JSON, keeping output aligned with the latest spec
- Actively maintained Apache-2.0 project (release 1.1.0 dated June 2026) fitting cleanly into Ruby CI pipelines
Where Vulnesis adds to it: Vulnesis ingests cyclonedx-ruby output (or generates its own CycloneDX 1.7 + SPDX 2.3 for Ruby) and adds cross-scanner dedup into one prioritised queue, exploit-intel prioritisation (EPSS/KEV/ESS/CWSS/LEV), reachability, immutable versioned VEX + audit, EOL and SSVC policy, and Safe Harbour autofix PRs. Better together: the gem supplies the authoritative Bundler inventory, Vulnesis turns it into prioritised, remediable risk - it does not replace the generator.
No migration, no rip-and-replace. CycloneDX Ruby Gem keeps doing what it does best; Vulnesis adds the orchestration, exploit-intelligence prioritisation and remediation layer built for the way AppSec works today. Software Factory agents on a Pix Sandbox can then turn the findings from any scanner into pull requests that a person approves. How Software Factory works.
Centralise CycloneDX Ruby Gem results in Vulnesis
Upload CycloneDX Ruby Gem CycloneDX output to the Vulnesis platform to deduplicate findings, prioritise them with EPSS, CISA KEV and Coalition ESS exploit intelligence, and track remediation across every scanner in a single queue.