Skip to content

STAC-22594 Documented how to verify signature of docker images - #404

Merged
LukaszMarchewka merged 7 commits into
mainfrom
STAC-25594-doc-how-to-verify-signature
Sep 16, 2026
Merged

LukaszMarchewka merged 7 commits into
mainfrom
STAC-25594-doc-how-to-verify-signature

Conversation

@LukaszMarchewka

Copy link
Copy Markdown
Contributor

No description provided.

@LukaszMarchewka
LukaszMarchewka requested a review from a team as a code owner August 26, 2026 13:02
@netlify

netlify Bot commented Aug 26, 2026

Copy link
Copy Markdown

Deploy Preview for suse-obs ready!

Name Link
🔨 Latest commit 73593d5
🔍 Latest deploy log https://app.netlify.com/projects/suse-obs/deploys/6aaa4ed86a08c50008c2288d
😎 Deploy Preview https://deploy-preview-404--suse-obs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Comment thread docs/latest/modules/en/pages/setup/security/verify-image-signatures.adoc Outdated
Comment thread docs/latest/modules/en/pages/setup/security/verify-image-signatures.adoc Outdated
Comment thread docs/latest/modules/en/pages/setup/security/verify-image-signatures.adoc Outdated
Comment thread docs/latest/modules/en/pages/setup/security/verify-image-signatures.adoc Outdated

Signing is keyless: there is no public key file to download or manage. Instead, each signature is backed by a short-lived certificate tied to the GitHub Actions job that produced it, and a public, tamper-evident record of the signing event.

Image signing was added to our build pipeline recently. Images published before this was rolled out do not carry a signature — verifying one of those tags fails with `no signatures found`, which does not indicate a problem with the image itself. If you rely on signature verification, pull a current tag.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Image signing was added to our build pipeline recently. Images published before this was rolled out do not carry a signature — verifying one of those tags fails with `no signatures found`, which does not indicate a problem with the image itself. If you rely on signature verification, pull a current tag.
Image signing was introduced for platform images in release vX.Y.Z and for agent images in release vA.B.C.. Images published before this was rolled out do not carry a signature — verifying one of those tags fails with `no signatures found`, which does not indicate a problem with the image itself. If you rely on signature verification, pull a current tag.


== Overview

{stackstate-product-name} container images are cryptographically signed during the build pipeline using https://www.sigstore.dev/[Sigstore] keyless signing (`cosign`). Verifying a signature confirms that an image was genuinely built by our CI from a specific source repository, workflow, and branch or tag — before you pull it into a cluster.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
{stackstate-product-name} container images are cryptographically signed during the build pipeline using https://www.sigstore.dev/[Sigstore] keyless signing (`cosign`). Verifying a signature confirms that an image was genuinely built by our CI from a specific source repository, workflow, and branch or tag — before you pull it into a cluster.
{stackstate-product-name} container images are cryptographically signed during the build pipeline using link:https://www.sigstore.dev/[Sigstore] keyless signing (`cosign`). Verifying a signature confirms that an image was genuinely built by our CI from a specific source repository, workflow, and branch or tag — before you pull it into a cluster.

Comment thread docs/latest/modules/en/pages/setup/security/verify-image-signatures.adoc Outdated

@akashraj4261 akashraj4261 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Minor comments

@LukaszMarchewka
LukaszMarchewka force-pushed the STAC-25594-doc-how-to-verify-signature branch from 85ee972 to 73593d5 Compare September 16, 2026 08:09
@LukaszMarchewka
LukaszMarchewka changed the base branch from staging to main September 16, 2026 08:11
@l4zy0n3

l4zy0n3 commented Sep 16, 2026

Copy link
Copy Markdown
Collaborator
$ cosign verify \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com \
  --certificate-identity-regexp='^https://github.com/StackVista/.*' \
  registry.rancher.com/suse-observability/stackstate-ui:2.11.1

Verification for registry.rancher.com/suse-observability/stackstate-ui:2.11.1 --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate was verified using trusted certificate authority certificates

[{"critical":{"identity":{"docker-reference":"registry.rancher.com/suse-observability/stackstate-ui:2.11.1"},"image":{"docker-manifest-digest":"sha256:6eb468d98c7d995aba410267e6da1d91a24b4ec0f2c8f57ba2b60cf536c8ce0f"},"type":"https://sigstore.dev/cosign/sign/v1"},"optional":{}}]

$ cosign verify \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com \
  --certificate-identity-regexp='^https://github.com/StackVista/.*' \
  registry.rancher.com/suse-observability/stackstate-k8s-agent:158e1098

Verification for registry.rancher.com/suse-observability/stackstate-k8s-agent:158e1098 --
The following checks were performed on each of these signatures:
  - The cosign claims were validated
  - Existence of the claims in the transparency log was verified offline
  - The code-signing certificate was verified using trusted certificate authority certificates

[{"critical":{"identity":{"docker-reference":"registry.rancher.com/suse-observability/stackstate-k8s-agent:158e1098"},"image":{"docker-manifest-digest":"sha256:35e66696a1bdc0d470e0d11d7711e426548a09d31190bdd94cd1350b464dc839"},"type":"https://sigstore.dev/cosign/sign/v1"},"optional":{}}]

@LukaszMarchewka
LukaszMarchewka merged commit 8058bba into main Sep 16, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants