Skip to content

docs: document vprox credential rotation - #25

Merged
bruce-y merged 2 commits into
mainfrom
bruce-y/credential-rotation-runbook
Oct 21, 2026
Merged

bruce-y merged 2 commits into
mainfrom
bruce-y/credential-rotation-runbook

Conversation

@bruce-y

@bruce-y bruce-y commented Oct 21, 2026 •

Copy link
Copy Markdown

Add a detailed operator runbook for rotating passwords across both vprox control servers and enabled relays. It covers singular/plural password semantics, the actual deployed Doppler config, gateway coverage and management access, bind-address lifetime checks, relay session drain, client transition, retirement, and recovery.

Include separate old/new/invalid probes for the control endpoint and the relay handshake. The relay probe verifies the channel-bound server proof. The runbook is self-contained and states that runner hosts must be rolled and outgoing old-key jobs must finish before retirement; it also explains how an excluded gateway can safely return to service.

Validated Bash/Python snippets, relative links, and Go formatting on Blacksmith Testbox; the embedded relay probe compiles against this repository. No production configuration or runtime code changes.

Related service runbooks:

Capture the staged rotation procedure, verification gates, and recovery steps so an operator can repeat the work without relying on chat history.
@blacksmith-staging

blacksmith-staging Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Matches Relay probe: new/old ok, invalid refused

The runbook's probe built from the repo and, against a live relay, passed new/old with verified proofs during overlap and rejected old after retirement; mismatched phases exit non-zero.

Relay probe by phase

Also checked · 3 match

Matches Control probe: 400 accepted, 401 rejected
Matches Singular literal, plural trimmed, empty rejected
Matches README and RELAY links resolve

Proof on 1f76542f

View full Proof report

Keep the runner rollout requirement in this service runbook and remove the dependency on a separate fa coordination runbook.
@bruce-y
bruce-y merged commit dd515cb into main Oct 21, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants