As of v10.9, the CloudBees CD/RO server installation binaries are signed to allow you to verify their origin and authenticity. Verifying the origin and authenticity of binaries is an optional step in the installation process. It can help ensure that you are not the victim of an attack.
To verify the CloudBees CD/RO installation binaries, you must download Cosign verification software. Cosign is a component of the Sigstore solution, a collection of projects designed to make software signatures easier.
To verify the authenticity of CloudBees CD/RO server installation binaries:
-
Run the following command to download the public key:
wget https://cdn.cloudbees.com/keyring/cloudbees.pub
-
Run the following command to verify the downloaded binaries:
CommandCurrent versioncosign-linux-amd64 verify-blob \ --signature signatureUrl/downloadedBinary.sig \ --key cloudbees.pub \ CloudBeesFlow-x64-<version>
cosign-linux-amd64 verify-blob \ --signature signatureUrl/downloadedBinary.sig \ --key cloudbees.pub \ CloudBeesFlow-x64-2024.09.0.176472
-
You can also run the following command to reference the key URL directly.
IPv6 addresses are only supported for Kubernetes platforms. If using an IPv6 address, enclose the address in square brackets. Example: [<IPv6-ADDRESS>]
.CommandCurrent versioncosign-linux-amd64 verify-blob \ --signature signatureUrl/downloadedBinary.sig \ --key https://cdn.cloudbees.com/keyring/cloudbees.pub \ CloudBeesFlow-x64-<version>
cosign-linux-amd64 verify-blob \ --signature signatureUrl/downloadedBinary.sig \ --key https://cdn.cloudbees.com/keyring/cloudbees.pub \ CloudBeesFlow-x64-2024.09.0.176472
-
Cosign must be able to access the file to verify the images or the verification fails. Below is an example of failed validation.
cosign verify-blob \ --signature https://downloads.cloudbees.com/cloudbees-cd/Release_2024.09/2024.09.0.176472/linux/CloudBeesFlow-x64-2024.09.0.176472.sig \ --key https://cdn.cloudbees.com/keyring/cloudbees.pub \ CloudBeesFlow-x64-2024.09.0.176472 Error: verifying blob [CloudBeesFlow-x64-2024.09.0.176472]: invalid signature when validating ASN.1 encoded signature main.go:62: error during command execution: verifying blob [CloudBeesFlow-x64-2024.09.0.176472]: invalid signature when validating ASN.1 encoded signature