Skip to content

dx: improve auth setup error messages#74

Open
kumarabhirup wants to merge 1 commit into
mainfrom
dx/33-improve-auth-error-messages
Open

dx: improve auth setup error messages#74
kumarabhirup wants to merge 1 commit into
mainfrom
dx/33-improve-auth-error-messages

Conversation

@kumarabhirup
Copy link
Copy Markdown
Collaborator

Fixes #33

Improves auth error messages across gateway HTTP, WebSocket, and webhook paths to include descriptive reasons and fix hints instead of bare 'Unauthorized' responses.

Replace cryptic 'Unauthorized' responses with descriptive messages that
tell the user what went wrong and how to fix it:

- HTTP auth failures now include specific reasons (token_mismatch,
  password_missing, trusted_proxy_untrusted_source, etc.) with
  actionable hints (which env var or config key to check)
- WebSocket upgrade 401s now return JSON with the failure reason
  instead of a bare 'HTTP/1.1 401 Unauthorized'
- Webhook auth failures explain secret mismatch
- assertGatewayAuthConfigured password error now suggests the env var
- gateway URL override error explains what credentials are needed

Closes #33
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.

Error messages for auth setup failures are cryptic

1 participant