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