runbook: correct the WEBHOOK_TOKEN rotation state (rotated 2026-10-27; URL match unverified)

This commit is contained in:
inference-bot committed 2026-10-28 14:03:56 +00:00
1 parent d7cee510cb
commit 340fbe9062
1 file changed
+9 -3
+9 -3
View File
@@ -60,9 +60,15 @@ cutover completed 2026-10-28 (`ADMIN_TOKEN_LEGACY=0`), verified on the wire:
- **Rotating `ADMIN_TOKEN` touches THREE places** — the portal env (shared by the - **Rotating `ADMIN_TOKEN` touches THREE places** — the portal env (shared by the
app and the scheduler addon), the admin panel's separate copy, and the agent's app and the scheduler addon), the admin panel's separate copy, and the agent's
`~/.hermes/.env`. Miss one and that caller 403s silently. `~/.hermes/.env`. Miss one and that caller 403s silently.
- **Rotating `WEBHOOK_TOKEN` needs Open Collective admin access**, because the - **`WEBHOOK_TOKEN` was rotated on 2026-10-27**, as a precaution after a test
value lives in the webhook URL on the collective — the same blocker as moving handled the URL. Rotating it *again* means updating BOTH the portal env and the
`OC_PERSONAL_TOKEN` (below) to a co-op-owned account. webhook URL configured on the collective, which needs Open Collective admin
access — the same blocker as moving `OC_PERSONAL_TOKEN` (below) to a
co-op-owned account.
- **Unverified:** whether the collective's webhook URL was updated in step with
that rotation. The route compares the URL token against the env var, so a
mismatch makes OC's deliveries 401 and new-member provisioning waits for the
nightly sweep (delayed, not lost). Treat the first real OC event as the test.
- **No caller may fall back from `ADMIN_TOKEN` to `WEBHOOK_TOKEN`.** The legacy - **No caller may fall back from `ADMIN_TOKEN` to `WEBHOOK_TOKEN`.** The legacy
token 403s, so a fallback turns "unset" into a confusing mid-run failure token 403s, so a fallback turns "unset" into a confusing mid-run failure
instead of a clear abort. instead of a clear abort.