Repository navigation
Releases
Releases · ftaeger/pbs-sync-auth
v1.0.1
No changes to the server or client code; the protocol is unchanged. This
release is about how pbs-sync-auth is built, published and verified.
Changed
- Server image: releases are now also tagged with the floating major tag
(:1), alongside:X.Y.Zand:X.Y, so you can pin a major line and still
receive patch and security updates. Docs and examples use:1. - The APT repository moved to
https://apt.pbs-sync-auth.com/. The old
https://ftaeger.github.io/pbs-sync-auth/URL redirects there, so existing
sources keep working; updating/etc/apt/sources.list.d/pbs-sync-auth.list
is recommended. - Server image: dropped the redundant
v-prefixed tag (:vX.Y.Z); use
:X.Y.Z. Pre-release tags no longer move:latest.
Security
- Release binaries, the client
.deband the server image now carry signed
build provenance attestations (gh attestation verify, seeSECURITY.md). - CI: all GitHub Actions and the Go builder image are pinned to immutable
digests (kept current by Dependabot); workflow token permissions reduced to
the minimum per job; checkouts no longer persist credentials. - Added
SECURITY.md(private vulnerability reporting) and an OpenSSF
Scorecard workflow.
Added
CONTRIBUTING.md,CODE_OF_CONDUCT.md, issue forms and a pull request
template.
v1.0.0
First stable release. Upgrading is strongly recommended: all earlier
releases were built with Go 1.23 (end of life), and govulncheck reports 34
reachable standard-library vulnerabilities (crypto/tls, crypto/x509,
net/http, …) in each of their binaries. 1.0.0 is built with Go 1.27.3 and has
none. The protocol is unchanged; 1.0.0 clients and servers interoperate with
0.0.x.
Security
- Build server, client, image and
.debwith Go 1.27 (check-latest);go.mod
floorgo 1.26. - Server: cap request bodies at 4 KiB.
- Server: cap outstanding challenges (
PBS_MAX_PENDING, default 100); further
/auth/challengerequests get503. - Server: fix a leaked idle TLS connection per
/auth/verifyin the target-PBS
probe. - Client: cap auth-server responses at 64 KiB (the challenge response is read
before the server proof is verified). - Client: warn if
secret.keyis readable by group or others. - systemd units:
NoNewPrivileges=yes,PrivateTmp=yes.
Added
- Server logs every auth result with the client IP (
auth ok for …,
auth denied for …: <reason>). PBS_TRUSTED_PROXIES: CIDRs/IPs of reverse proxies whoseX-Forwarded-For/
X-Real-IPis trusted for that client IP (rightmost non-trusted hop; logging
only, never used for authentication). Unset = headers ignored.- Reverse-proxy examples: per-IP rate limits (Traefik, nginx, HAProxy),
listener-wide for Envoy, documented options for Caddy and Apache; commented IP
allowlists; client IP forwarded viaX-Forwarded-For. - CI runs
go test -raceandgovulncheck, plus a weekly scheduled scan;
Dependabot for Go modules, the Docker base image and GitHub Actions.
Changed
- Server
WriteTimeoutderives fromPBS_TARGET_TIMEOUT, so a slow target
probe no longer cuts off the/auth/verifyresponse. - Bumped GitHub Actions and the example proxy images (Traefik v3.7, nginx 1.30,
HAProxy 3.4 LTS, Envoy v1.40).
Upgrade notes
- Server: pull the new image. Behind a reverse proxy, set
PBS_TRUSTED_PROXIES
to the proxy's network, otherwise the proxy's address is logged. - Client:
apt update && apt upgrade(the running daemon is restarted).
v0.0.5
What's Changed
- ci: idempotent release job (fix rerun failures) by @ftaeger in #9
- client: surface successful pbs-sync-auth check in skip logs by @ftaeger in #10
Full Changelog: v0.0.4...v0.0.5
v0.0.4
What's Changed
Full Changelog: v0.0.3...v0.0.4
v0.0.3
What's Changed
- CI: gate release artifacts to tags + add concurrency by @ftaeger in #2
- docs: add Installation section to README by @ftaeger in #5
- docs: prettier README, no-sudo client docs, reverse-proxy examples by @ftaeger in #6
- Target-PBS reachability gate + config-driven client daemon by @ftaeger in #7
Full Changelog: v0.0.2...v0.0.3
v0.0.2
v0.0.1
Full Changelog: https://github.com/ftaeger/pbs-sync-auth/commits/v0.0.1