Skip to content

Commit 3286f23

Browse files
committed
Add docs about verifying Sigstore Bundles with Policy Controller
Signed-off-by: Cody Soyland <codysoyland@github.com>
1 parent cb70e79 commit 3286f23

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

content/en/policy-controller/overview.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,32 @@ regular expressions.
192192
- `issuer`: specifies the issuer certificate was issued by. Regex patterns are supported through the `issuerRegExp` key.
193193
- `subject`: specifies the subject certificate was issued to. Regex patterns are supported through the `subjectRegExp` key.
194194

195+
#### Sigstore bundle format
196+
197+
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.
198+
199+
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:
200+
201+
```yaml
202+
apiVersion: policy.sigstore.dev/v1beta1
203+
kind: ClusterImagePolicy
204+
metadata:
205+
name: image-policy
206+
spec:
207+
images:
208+
- glob: "**"
209+
authorities:
210+
- keyless:
211+
url: https://fulcio.example.com
212+
identities:
213+
- issuer: https://accounts.google.com
214+
subject:
215+
signatureFormat: bundle
216+
attestations:
217+
- name: require-attestation
218+
predicateType: https://slsa.dev/provenance/v1
219+
```
220+
195221
### Configuring `static` authorities
196222

197223
Authorities can be `static` specifications. These are used for example when

0 commit comments

Comments
 (0)