Skip to content

Commit dc17982

Browse files
heyvaldemarVladimir Mikhalev
andauthored
docs(security): sync SECURITY.md Supply Chain Trust with runbook v1.2 template (#20)
One-line drift identified during the v1.2 post-release audit of the keycloak reference-implementation against the runbook templates. The Supply Chain Trust section of SECURITY.md still said "Upstream image tags are pinned to specific versions and will migrate to immutable @sha256:... digests in an upcoming PR" — but that migration actually shipped in PR #14 (merged 2026-04-23). The "upcoming" language has been stale for ~6 weeks. Replaces that sentence with the current-state description from the runbook's templates/SECURITY.md.tmpl: - Digests pinned in .env.example with the full tag@sha256: form - Dependabot docker-ecosystem weekly bumps - CI Deployment Verification weekly drift detection (Monday 06:00 UTC) - Adds the GitHub-Actions-pinned-by-commit-SHA statement No functional change — just sync documentation with what's actually been deployed since PR #14. Also documents the sync in CHANGELOG.md under [Unreleased] → Changed with a link to runbook v1.2.0. Close drift item against: - self-host-repo-hardening-runbook v1.2.0 templates/SECURITY.md.tmpl Co-authored-by: Vladimir Mikhalev <ask@sre.gg>
1 parent d8f2c17 commit dc17982

2 files changed

Lines changed: 10 additions & 1 deletion

File tree

CHANGELOG.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
5858
(`0 6 * * 1`) for upstream image drift detection, and `workflow_dispatch`
5959
trigger for manual runs. Workflow file renamed `00-deployment-verification.yml`
6060
`deployment-verification.yml`.
61+
- `SECURITY.md` Supply Chain Trust section synced with
62+
[self-host-repo-hardening-runbook v1.2](https://github.com/heyvaldemar/self-host-repo-hardening-runbook/releases/tag/v1.2.0)
63+
template. Replaces the stale "will migrate to immutable `@sha256:...` digests
64+
in an upcoming PR" language (that migration shipped in PR #14) with the
65+
current-state description: digests pinned in `.env.example`, Dependabot
66+
weekly bumps, CI weekly drift detection. Adds the GitHub-Actions-pinned-by-
67+
commit-SHA statement that the template now includes.
6168

6269
### Removed
6370
- `.github/FUNDING.yml` — sponsor discovery moves to heyvaldemar.com. Aligns with the same decision applied across other heyvaldemar public repositories.

SECURITY.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,9 @@ This repository publishes a **deployment template**, not a custom Docker image.
2525
- [`quay.io/keycloak/keycloak`](https://quay.io/repository/keycloak/keycloak) — Keycloak upstream
2626
- [`postgres`](https://hub.docker.com/_/postgres) — PostgreSQL, official image
2727

28-
Upstream image tags are pinned to specific versions and will migrate to immutable `@sha256:...` digests in an upcoming PR. Dependabot's `docker` ecosystem tracks digest bumps weekly.
28+
Upstream image tags are pinned to `tag@sha256:<digest>` in `.env.example`. Dependabot's `docker` ecosystem tracks digest bumps weekly. CI's Deployment Verification workflow stands up the full compose stack on every push and every Monday at 06:00 UTC, catching upstream drift before it reaches users.
29+
30+
GitHub Actions are pinned by commit SHA with `# vX.Y.Z` version comments.
2931

3032
## Known historical issue
3133

0 commit comments

Comments
 (0)