Installation
To install sops, download one of the pre-built binaries provided for your platform from the artifacts attached to this release.
For instance, if you are using Linux on an AMD64 architecture:
:::shell
# Download the binary
curl -LO https://github.com/getsops/sops/releases/download/v3.9.4/sops-v3.9.4.linux.amd64
# Move the binary in to your PATH
mv sops-v3.9.4.linux.amd64 /usr/local/bin/sops
# Make the binary executable
chmod +x /usr/local/bin/sops
Verify checksums file signature
The checksums file provided within the artifacts attached to this release is signed using Cosign with GitHub OIDC. To validate the signature of this file, run the following commands:
:::shell
# Download the checksums file, certificate and signature
curl -LO https://github.com/getsops/sops/releases/download/v3.9.4/sops-v3.9.4.checksums.txt
curl -LO https://github.com/getsops/sops/releases/download/v3.9.4/sops-v3.9.4.checksums.pem
curl -LO https://github.com/getsops/sops/releases/download/v3.9.4/sops-v3.9.4.checksums.sig
# Verify the checksums file
cosign verify-blob sops-v3.9.4.checksums.txt \
--certificate sops-v3.9.4.checksums.pem \
--signature sops-v3.9.4.checksums.sig \
--certificate-identity-regexp=https://github.com/getsops \
--certificate-oidc-issuer=https://token.actions.githubusercontent.com
Verify binary integrity
To verify the integrity of the downloaded binary, you can utilize the checksums file after having validated its signature:
:::shell
# Verify the binary using the checksums file
sha256sum -c sops-v3.9.4.checksums.txt --ignore-missing
Verify artifact provenance
The SLSA provenance of the binaries, packages, and SBOMs can be found within the artifacts associated with this release. It is presented through an in-toto link metadata file named sops-v3.9.4.intoto.jsonl. To verify the provenance of an artifact, you can utilize the slsa-verifier tool:
:::shell
# Download the metadata file
curl -LO https://github.com/getsops/sops/releases/download/v3.9.4/sops-v3.9.4.intoto.jsonl
# Verify the provenance of the artifact
slsa-verifier verify-artifact <artifact> \
--provenance-path sops-v3.9.4.intoto.jsonl \
--source-uri github.com/getsops/sops \
--source-tag v3.9.4
Container Images
The sops binaries are also available as container images, based on Debian (slim) and Alpine Linux. The Debian-based container images include any dependencies which may be required to make use of certain key services, such as GnuPG, AWS KMS, Azure Key Vault, and Google Cloud KMS. The Alpine-based container images are smaller in size, but do not include these dependencies.
These container images are available for the following architectures: linux/amd64 and linux/arm64.
GitHub Container Registry
ghcr.io/getsops/sops:v3.9.4ghcr.io/getsops/sops:v3.9.4-alpine
Quay.io
quay.io/getsops/sops:v3.9.4quay.io/getsops/sops:v3.9.4-alpine
Verify container image signature
The container images are signed using Cosign with GitHub OIDC. To validate the signature of an image, run the following command:
:::shell
cosign verify ghcr.io/getsops/sops:v3.9.4 \
--certificate-identity-regexp=https://github.com/getsops \
--certificate-oidc-issuer=https://token.actions.githubusercontent.com \
-o text
Verify container image provenance
The container images include SLSA provenance attestations. For more information around the verification of this, please refer to the slsa-verifier documentation.
Software Bill of Materials
The Software Bill of Materials (SBOM) for each binary is accessible within the artifacts enclosed with this release. It is presented as an SPDX JSON file, formatted as <binary>.spdx.sbom.json.
What's Changed
- build(deps): Bump the go group with 5 updates by @dependabot in https://github.com/getsops/sops/pull/1727
- build(deps): Bump tempfile from 3.14.0 to 3.15.0 in /functional-tests in the rust group by @dependabot in https://github.com/getsops/sops/pull/1728
- build(deps): Bump the go group with 16 updates by @dependabot in https://github.com/getsops/sops/pull/1732
- build(deps): Bump the ci group with 3 updates by @dependabot in https://github.com/getsops/sops/pull/1730
- build(deps): Bump serde_json from 1.0.134 to 1.0.135 in /functional-tests in the rust group by @dependabot in https://github.com/getsops/sops/pull/1731
- build(deps): Bump the go group with 12 updates by @dependabot in https://github.com/getsops/sops/pull/1734
- build(deps): Bump serde_json from 1.0.135 to 1.0.137 in /functional-tests in the rust group by @dependabot in https://github.com/getsops/sops/pull/1735
- Fix ToString for AWS KMS to include role, context, and profile by @felixfontein in https://github.com/getsops/sops/pull/1733
- build(deps): Bump the ci group with 3 updates by @dependabot in https://github.com/getsops/sops/pull/1738
- build(deps): Bump the go group with 6 updates by @dependabot in https://github.com/getsops/sops/pull/1739
- Release 3.9.4 by @felixfontein in https://github.com/getsops/sops/pull/1740
Full Changelog: https://github.com/getsops/sops/compare/v3.9.3...v3.9.4