Tool integration

Spectral integration guide

Open-source API linter for OpenAPI, AsyncAPI, and any JSON/YAML document

Get a Free API Key

Integrate Spectral with Vulnesis. Lint OpenAPI and AsyncAPI specifications for security misconfigurations and best practice violations, then upload SARIF findings to Vulnesis.

YAML / JSON / OpenAPI / AsyncAPICLI toolSARIFJSON

Install & scan

$ # Zero-install via npx
npx @stoplight/spectral-cli --version

# Or install globally
npm install -g @stoplight/spectral-cli
$ npx @stoplight/spectral-cli lint api.yaml   --ruleset spectral.yml   --format sarif   --output spectral.sarif

Run Spectral in CI

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

- name: Lint API specification with Spectral
  run: npx @stoplight/spectral-cli lint api.yaml --format sarif --output spectral.sarif

- name: Upload report
  uses: actions/upload-artifact@v6
  with:
    name: spectral
    path: spectral.sarif
    if-no-files-found: warn

Then one publish job hands every artifact in the run to Vulnesis, recorded under Spectral'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 Spectral. Keep running it. Vulnesis sits on top of Spectral (and every other scanner you already own) turning disconnected tool outputs into one prioritised, fixable queue.

CapabilityVulnesisSpectral
Security coverage
SAST (static code analysis)✓ Built-in rules + Semgrep augmentation~ Static linting of API description documents (OpenAPI/AsyncAPI), not application source code
SCA / dependencies✓ 40+ ecosystems, transitive graph✗
DAST (dynamic testing)~ Ingests DAST results; no native dynamic engine✗ Never runs against a live application; it analyzes spec files only, not runtime behavior
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✗
SBOM generation✓ CycloneDX 1.7 + SPDX 2.3, cosign-signable✗
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 Spectral does well

Where Vulnesis adds to it: Spectral governs API design quality statically at authoring time; it is not a scanner. Vulnesis consolidates real vulnerability findings from SAST, SCA, DAST, container, IaC and secrets scanners into one prioritised, deduplicated queue with exploit-intel (EPSS/KEV/LEV), reachability and versioned VEX, layers Spectral has no equivalent of. They are complementary: Spectral keeps API contracts clean upstream while Vulnesis orchestrates the security findings across the whole stack.

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

Upload Spectral SARIF, 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.

Spectral documentation ↗  ·  Source repository ↗

Wire Spectral into your CI/CD pipeline →