Installation

CLI

npx (no install)

npx @cerberauth/stubidp --redirect-uri http://localhost:8080/callback

npm global

npm install -g @cerberauth/stubidp

Then run:

stubidp --redirect-uri http://localhost:8080/callback

Dev dependency

npm install --save-dev @cerberauth/stubidp

Add a script to your package.json:

{
  "scripts": {
    "idp": "stubidp --redirect-uri http://localhost:8080/callback"
  }
}

Verify the server is running:

curl http://localhost:8484/.well-known/openid-configuration

Caution

stubIdP is intended for development and testing only. Do not use it as a production identity provider.

Cloudflare Workers

To deploy stubIdP as a globally distributed OIDC server, see the Cloudflare Workers guide.