OAuth guides

Use dummyoauth with Amazon Cognito

Point Amazon Cognito at a dummyoauth mock issuer for local OAuth and OIDC development. Dashboard Integration env vars, redirect URI, and production swap steps.

8 min read

Amazon Cognito expects an OAuth/OIDC issuer, client credentials, and a registered redirect URI. dummyoauth is a mock IdP for development and test. Add the Cognito preset in your dummyoauth project so discovery paths match AWS hosted UI style URLs.

Dashboard setup

  1. Sign in and create a project in the dashboard.
  2. Add the Cognito provider preset.
  3. Register redirect URI http://localhost:3009/callback on your OAuth client.
  4. Add dummy users for consent screens.
  5. Copy env vars from the Integration panel.

Environment and config

Replace placeholders with values from Integration:

EXAMPLE_APP_ORIGIN=http://localhost:3009
OAUTH_ISSUER=https://dummyoauth.com/p/your-project/emulate/cognito
OAUTH_CLIENT_ID=<client-id>
OAUTH_CLIENT_SECRET=<client-secret>

Run the example repo

Clone dummyOAuth/example/cognito (port 3009). In the main dummyoauth monorepo you can also run:

pnpm dev:example:cognito

All framework integrations.

Production swap

Update issuer and client credentials to your production IdP. Keep variable names stable. Do not use dummyoauth for real user authentication.