From 02a5145a7516ee98af42c914c6115c2ddca5a24c Mon Sep 17 00:00:00 2001 From: Vishal Rana Date: Sun, 8 Nov 2026 10:56:02 -0800 Subject: [PATCH] docs(auth): break-glass works after a restart during an outage OIDC discovery no longer exits at startup, so the note that break-glass needs an already-running server is out of date. --- docs/authentication.md | 6 +++--- site/src/content/docs/docs/concepts/authentication.mdx | 5 ++--- 2 files changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/authentication.md b/docs/authentication.md index 3915da7d..cab150b5 100644 --- a/docs/authentication.md +++ b/docs/authentication.md @@ -122,9 +122,9 @@ issue a new one. proxy, set `FANOUT_TRUSTED_PROXY_CIDRS`; otherwise every request shares the proxy's address and one limit, and other traffic can block recovery. -Fanout contacts the identity provider's discovery endpoint when the server -starts, and exits if that fails. Break-glass access therefore needs a server -that is already running; do not restart Fanout during the outage. +Fanout starts while the identity provider is unavailable, so break-glass access +also works after a restart during the outage. See +[Provider availability](#provider-availability). ### User account API diff --git a/site/src/content/docs/docs/concepts/authentication.mdx b/site/src/content/docs/docs/concepts/authentication.mdx index c0f12920..4db20a68 100644 --- a/site/src/content/docs/docs/concepts/authentication.mdx +++ b/site/src/content/docs/docs/concepts/authentication.mdx @@ -161,9 +161,8 @@ docker exec fanout fanout login-link --break-glass admin@example.com Set `FANOUT_AUTH_CODE_SECRET` with at least 32 characters before you need this. OIDC mode does not require it at startup, but without it the command fails and -the server keeps login links disabled. The server must also be running already: -Fanout contacts the provider's discovery endpoint at startup and exits if that -fails. +the server keeps login links disabled. Fanout starts while the provider is +unavailable, so this also works after a restart during the outage. The command refuses other roles, suspended users and local mode. The URL expires in 15 minutes and works once. In OIDC mode, the server accepts only these links