diff --git a/content/en/verifying/verify.md b/content/en/verifying/verify.md index ff0ba9a6..03ac61e9 100644 --- a/content/en/verifying/verify.md +++ b/content/en/verifying/verify.md @@ -80,12 +80,24 @@ $ cosign verify --certificate cosign.crt --certificate-chain chain.crt user/demo ``` ## Verify image with user-provided trusted chain -Verify image with the provided certificate chain and identity parameters (intended for -a "bring your own PKI" use case): - +Verify image with the provided certificate chain(s) and identity parameters (intended for +a "bring your own PKI" use cases). +* with a single certificate chain file - which may contain one or several intermediate +certificates followed by the root CA certificate - use the `--certificate-chain` parameter: ```shell $ cosign verify --certificate-chain chain.crt --certificate-oidc-issuer https://issuer.example.com --certificate-identity foo@example.com user/demo ``` +* with a certificate bundle PEM file containing several CA roots (but no intermediate certificate), use the `--ca-roots` parameter: +```shell +$ cosign verify --ca-roots ca-roots.pem --certificate-oidc-issuer https://issuer.example.com --certificate-identity foo@example.com user/demo +``` + +The `--ca-roots` and `--certificate-chain` flags are mutually exclusive. + +Note that the hypothetical use case of "multiple chains with multiple CA roots and intermediate +certificates" is not yet supported. There are plans to add the `--ca-intermediates` parameter +(see [issue #3462](https://github.com/sigstore/cosign/issues/3462)), if you needs this, +please open an issue and mention it on the Sigstore #cosign Slack. ## Verify an image on the transparency log