Skip to content

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 24 Oct 10:41
· 5 commits to main since this release
fe0941d

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 .deb with Go 1.27 (check-latest); go.mod
    floor go 1.26.
  • Server: cap request bodies at 4 KiB.
  • Server: cap outstanding challenges (PBS_MAX_PENDING, default 100); further
    /auth/challenge requests get 503.
  • Server: fix a leaked idle TLS connection per /auth/verify in 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.key is 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 whose X-Forwarded-For /
    X-Real-IP is 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 via X-Forwarded-For.
  • CI runs go test -race and govulncheck, plus a weekly scheduled scan;
    Dependabot for Go modules, the Docker base image and GitHub Actions.

Changed

  • Server WriteTimeout derives from PBS_TARGET_TIMEOUT, so a slow target
    probe no longer cuts off the /auth/verify response.
  • 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).