dummyauth

OAuth guides

Use dummyoauth with WorkOS

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

8 min read

WorkOS expects an OAuth/OIDC issuer, client credentials, and a registered redirect URI. dummyoauth is a mock IdP for development and test. Point a custom OIDC SSO connection at your dummyoauth issuer for enterprise flow testing.

Dashboard setup

  1. Sign in and create a project in the dashboard.
  2. Add the generic OIDC provider preset.
  3. Register redirect URI http://localhost:3012/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:3012
OAUTH_ISSUER=https://dummyoauth.com/p/your-project
OAUTH_CLIENT_ID=<client-id>
OAUTH_CLIENT_SECRET=<client-secret>

Run the example repo

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

pnpm dev:example:workos

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.

Related guides