Use the OCI Distribution Specification Referrers API to list all signatures and SBOMs attached to a container image digest

domain: github.com/opencontainers/distribution-spec · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Obtain the image manifest digest for the subject image using docker inspect --format '{{index .RepoDigests 0}}' <IMAGE> or via GET /v2/<name>/manifests/<tag> capturing the Docker-Content-Digest response header
  2. Query the referrers endpoint: GET https://<REGISTRY>/v2/<name>/referrers/<digest> with an Accept: application/vnd.oci.image.index.v1+json header; the registry returns an OCI image index listing all attached artifacts
  3. Filter by artifact type by appending a query parameter: GET /v2/<name>/referrers/<digest>?artifactType=application/vnd.cyclonedx+json to retrieve only CycloneDX SBOM referrers
  4. For each referrer in the manifests array, pull the artifact manifest using GET /v2/<name>/manifests/<referrer_digest> and then fetch the blob using the layer digest to retrieve the SBOM or signature payload
  5. Use the oras CLI as a higher-level alternative: oras discover <IMAGE>@<DIGEST> lists all referrers with their artifact types in a human-readable format

Known gotchas

Related routes

Attach a signed SBOM as a cosign attestation to an OCI image and verify the attestation in a downstream deployment step
security/compliance · 5 steps · unrated
Verify a cosign-signed container image using certificate-identity and OIDC issuer policy flags
slsa.dev · 6 steps · unrated
Sign container images with a cloud KMS-backed key (not keyless Fulcio signing) using cosign and verify against that key in a deploy pipeline
docs.sigstore.dev · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans