Overview
galteactl is the program that runs the install steps of a self-hosted or private Galtea deployment. Every release has three things you can check:
- A signature of each binary, made with the same key that signs Galtea’s container images.
- A signature of
SHA256SUMS, the file that lists the checksum of every other release file. - A software bill of materials (SBOM) for each binary: an SPDX JSON file that lists the Go modules the binary holds.
Requirements
- cosign 3.0 or later. The signature files use the bundle format of cosign 3.
- The AWS CLI and the read key profile of your delivery package guide (
galtea-artifactsbelow), to copy the files. The read key cannot list the folder, so each file is copied by its exact name. jq, to read the SBOM.
The public key
Save this key asimage-signing.pub. The same file is in each delivery package as policy/image-signing.pub. Compare the two before you trust either.
Verify a binary
Set the release (for example0.14.0) and the platform of your machine (linux_amd64, linux_arm64, darwin_amd64 or darwin_arm64).
Verified OK twice, then galteactl_linux_amd64: OK and galteactl_linux_amd64.spdx.json: OK. If a command prints anything else, do not run the binary, and write to support@galtea.ai.
Read the SBOM
The signature proves that a Galtea release job made the file. The signing key lives in AWS KMS and never leaves it. The signature goes to the public Sigstore transparency log, as the signatures of Galtea’s container images do.