Skip to content

docs: document console origin and redirect URI prerequisites#102

Merged
Bccorb merged 1 commit into
mainfrom
docs/admin-console-origin-redirect-prereqs
Jul 25, 2026
Merged

docs: document console origin and redirect URI prerequisites#102
Bccorb merged 1 commit into
mainfrom
docs/admin-console-origin-redirect-prereqs

Conversation

@Bccorb

@Bccorb Bccorb commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Closes #96.

What

Documents the two allowlist prerequisites for serving the admin console, both of which currently fail partway through a flow with no hint in the docs:

  • docs/configuration.md (WebAuthn ORIGINS row): the origin serving the console must be in ORIGINS, alongside the app origins.
  • docs/configuration.md (Admin dashboard section): a new "Prerequisites for browser flows started from the console" block listing both requirements for both deployment shapes (served directly by this API, or reverse-proxied via createSeamlessConsoleProxy), with the searchable symptoms (passkey/step-up start fine and fail at finish; OAuth start returns 400 before any redirect).
  • docs/oauth.md (Redirect Policy): the console callback shape <origin>/console/oauth/callback must be in each provider's redirectUris and registered with the identity provider, else redirect_uri_mismatch at consent.

Scope

Docs only. No code change.

@Bccorb
Bccorb merged commit 99f74c5 into main Jul 25, 2026
1 of 3 checks passed
@Bccorb
Bccorb deleted the docs/admin-console-origin-redirect-prereqs branch July 25, 2026 23:20
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.

Document the origin and redirect URI prerequisites for serving the admin console

1 participant