Supply Chain Security¶
Status
Release images and charts are signed with keyless cosign and carry SBOM and build provenance attestations. Images built from develop and feature branches are not signed yet.
Controls¶
| Control | Where |
|---|---|
| Dependency updates | Renovate, renovate.json |
| Base image tracking | Renovate for the FROM lines of the Containerfiles |
| Foreman and plugin versions | Pinned RPMs, tracked by Renovate with the rpm datasource, see Container Images |
| Base package errata | Weekly rebuild of develop |
| Go vulnerability scan | govulncheck in CI |
| Static analysis | golangci-lint with gosec in CI |
| Invisible character check | Unicode lint in CI |
| Generated code drift | make check-manifests in CI |
| Signed commits | GPG, by convention |
| Containerfile linting | hadolint with .hadolint.yaml in _container-build.yaml |
| Build provenance and SPDX SBOM | BuildKit, attached to every pushed image |
| SPDX and CycloneDX SBOMs | syft; workflow artifacts, and release assets for releases |
Release signing¶
The Release workflow signs only when the repository is public, which it is:
| Control | Tool | Workflow |
|---|---|---|
| Keyless image and chart signing | cosign with GitHub Actions OIDC | _container-build.yaml, release.yaml |
| GitHub build provenance | SLSA through actions/attest-build-provenance |
_container-build.yaml |
| SBOM attestation | CycloneDX from syft, attested with cosign | _container-build.yaml |
| Policy validation | Conforma with .conforma/policy.yaml |
_conforma-validate.yaml, not called by a pipeline yet |
Verify an image signature:
cosign verify ghcr.io/slauger/foreman-operator:0.1.0 \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
--certificate-identity-regexp 'github\.com/slauger/foreman-operator'
Verify a chart the same way with ghcr.io/slauger/charts/foreman-operator:0.1.0, and the build provenance with gh attestation verify oci://ghcr.io/slauger/foreman-operator:0.1.0 --owner slauger.
The Images workflow for develop and feature branches still runs with sign: false, which dates from the time the repository was private. Use release images where signatures matter.
Policy exceptions¶
.conforma/policy.yaml allows only Red Hat base image registries. The foreman, smart-proxy, and boot-files images copy packages or files from CentOS Stream 9 build stages, whose signatures are checked during the build. Whether the policy accepts these build stages is not checked yet.
License compliance¶
Images that ship GPL components are part of the supply chain obligations. Each image carries an org.opencontainers.image.licenses label. Release SBOMs list every package with its source RPM, and the release notes point to the published sources. See Container Images.