Skip to content

Attestation quickstart

Sign an SBOM in GitHub Actions with the runner's OIDC identity, then verify it with vulnetix attest verify pinned to that workflow and issuer.

Updated 04 Nov 2026Markdown

This page signs the SBOM a workflow generates and checks that signature in the same job, pinned to the workflow that made it. Signing uses public Sigstore and the runner’s own identity, not a Vulnesis credential.

Prerequisites

  • A GitHub repository where you can add a workflow.
  • A job that may request an OIDC token: permissions: id-token: write.
  • No Vulnesis plan or credentials. Both actions run in community mode without them.

1. Sign the SBOM

Add .github/workflows/sbom.yml:

name: SBOM
on: [push]
jobs:
  sbom:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      id-token: write          # lets the job sign as itself
    steps:
      - uses: actions/checkout@v5
      - uses: Vulnesis/cli/sbom@v4
        with:
          sign: true

The action runs vulnetix cdx --sign and writes, in .vulnetix/:

File Contents
sbom.cdx.json The SBOM, with an embedded JSF signature
sbom.cdx.json.sig Base64 signature
sbom.cdx.json.pem The short-lived Fulcio certificate
sbom.cdx.json.intoto.jsonl The same claim as a DSSE envelope

2. Verify it, pinned to this workflow

Add a step after the sbom step:

      - uses: Vulnesis/cli/attest@v4
        with:
          subject: .vulnetix/sbom.cdx.json
          args: --identity https://github.com/${{ github.workflow_ref }} --issuer github

github.workflow_ref is owner/repo/.github/workflows/<file>@<ref>, the identity Fulcio issues to the job. --identity is an exact match. --issuer github means https://token.actions.githubusercontent.com.

3. Read the result

A passing run prints the verdict and the signer:

[OK] sbom.cdx.json is signed, and the signature is valid.

Signed by
  https://github.com/acme/repo/.github/workflows/sbom.yml@refs/heads/main
  authenticated by https://token.actions.githubusercontent.com
  certificate issued by Sigstore public-good
  this is the repository you are in

A failed check exits 1, prints the check table under Why it failed, and fails the job.

4. Verify a copy elsewhere

Anyone holding the four files can run the same check:

vulnetix attest verify sbom.cdx.json \
  --identity https://github.com/acme/repo/.github/workflows/sbom.yml@refs/heads/main \
  --issuer github

Next

esc
↑ ↓ move↵ openSearches in your browser. A key like autonomy.max or a code like threshold_required jumps straight to it.