Repository navigation
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).