/oidc-server

Reusable OIDC mock server with generics and inmemory user store with hot reload.

Primary LanguageGoApache License 2.0Apache-2.0

oidc-server

OpenID Connect development server based on https://github.com/zitadel/oidc/tree/main/example/server.

Setup

Runtime environment variables

  • ISSUER: fully qualified domain name.
  • DATA_DIR: absolute path to stored mock data. e.g. /data.
  • PORT (optional): server port. Default: 10001. Expose accordingly if using containers.

Required files

  • ${DATA_DIR}/users/*.json: JSON files with key-value pairs of users for easier testing. Keys are ignored. Server will raise errors at login page if duplicated IDs are found for easier debugging. The ${DATA_DIR}/users folder is continuously watched for changes. See storage/user.go's User for available fields.

  • ${DATA_DIR}/redirect_uris.txt: valid redirect URIs to load at startup.

Examples

See example directory. Run with ./example/run, point to it in your client app and edit redirect_uris.txt accordingly.