Tool integration

ScanCode Toolkit integration guide

Best-in-class open-source licence, copyright, and package origin scanner

Get a Free API Key

Integrate ScanCode Toolkit with Vulnesis. Scan your codebase for licences, copyrights, and package metadata using ScanCode via uv, then upload the CycloneDX or SPDX SBOM to Vulnesis.

CLI toolCycloneDXSPDXJSON

Install & scan

$ # Recommended: run without global install
uv run --with scancode-toolkit scancode --version

# Or install globally
pip install scancode-toolkit
$ uv run --with scancode-toolkit scancode   --license --copyright --package   --cyclonedx scan-bom.cdx.json .

Run ScanCode Toolkit in CI

Scan on every push and upload the report as a workflow artifact:

- name: Install uv
  run: curl -LsSf https://astral.sh/uv/install.sh | sh

- name: Run ScanCode
  run: uv run --with scancode-toolkit scancode --license --copyright --package --cyclonedx bom.cdx.json .

- name: Upload report
  uses: actions/upload-artifact@v6
  with:
    name: scancode
    path: bom.cdx.json
    if-no-files-found: warn

Then one publish job hands every artifact in the run to Vulnesis, recorded under ScanCode Toolkit'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" --json

After the run, vulnetix gha status reports what was actually recorded.

How Vulnesis compares: better together

Vulnesis does not replace ScanCode Toolkit. Keep running it. Vulnesis sits on top of ScanCode Toolkit (and every other scanner you already own) turning disconnected tool outputs into one prioritised, fixable queue.

ScanCode Toolkit is strongest at its core category and also carries features in SCA, SBOM Generation, just as Vulnesis spans categories.

CapabilityVulnesisScanCode Toolkit
Security coverage
SAST (static code analysis)✓ Built-in rules + Semgrep augmentation✗
SCA / dependencies✓ 40+ ecosystems, transitive graph~ Detects package manifests, dependencies and origin, but vuln scanning is delegated to sibling VulnerableCode, not native
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✓ Core capability: full-text license + copyright detection against 1,600+ SPDX texts with high accuracy
SBOM generation✓ CycloneDX 1.7 + SPDX 2.3, cosign-signable~ Emits detailed scan inventories; SPDX/CycloneDX output via companion tooling rather than a full SBOM generator
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 ScanCode Toolkit does well

Where Vulnesis adds to it: ScanCode is the license/copyright detection reference standard; Vulnesis consumes its license findings and adds the vulnerability layer it does not attempt, exploit-intel prioritisation, cross-scanner dedup, versioned VEX, CycloneDX 1.7 / SPDX 2.3 SBOMs and autofix.

No migration, no rip-and-replace. ScanCode Toolkit 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 ScanCode Toolkit results in Vulnesis

Upload ScanCode Toolkit CycloneDX, SPDX, JSON 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.

ScanCode Toolkit documentation ↗  ·  Source repository ↗

Wire ScanCode Toolkit into your CI/CD pipeline →