Skip to content

DNM: Add section about verifying Sigstore bundles with Policy Controller #386

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 26 additions & 0 deletions content/en/policy-controller/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -192,6 +192,32 @@ regular expressions.
- `issuer`: specifies the issuer certificate was issued by. Regex patterns are supported through the `issuerRegExp` key.
- `subject`: specifies the subject certificate was issued to. Regex patterns are supported through the `subjectRegExp` key.

#### Sigstore bundle format

Policy Controller v0.13.0 added support for the recently introduced [Sigstore bundle format]({{< relref "about/bundle" >}}), which changes the way signatures and attestations are serialized and stored. These changes were made [starting in Cosign v2.4.0]({{< relref "cosign/verifying/verify#new-bundle-format" >}}) to standardize the way Sigstore metadata is represented across multiple language clients and to align with the OCI 1.1 manifest referrers API.

Currently only attestations, not plain signatures, are supported in the bundle format. If using Cosign to attest the image with `--new-bundle-format`, you'll need to enable the bundle signature format in your `ClusterImagePolicy` using the `signatureFormat` field. For example:

```yaml
apiVersion: policy.sigstore.dev/v1beta1
kind: ClusterImagePolicy
metadata:
name: image-policy
spec:
images:
- glob: "**"
authorities:
- keyless:
url: https://fulcio.example.com
identities:
- issuer: https://accounts.google.com
subject:
signatureFormat: bundle
attestations:
- name: require-attestation
predicateType: https://slsa.dev/provenance/v1
```

### Configuring `static` authorities

Authorities can be `static` specifications. These are used for example when
Expand Down
Loading