Simple OIDC client

Install

Install it using npm:

1$ npm i -g simple-oidc-client

then the server is in your path (simple-oidc-client)

or clone the source repository:

1$ git clone https://github.com/linagora/simple-oidc-client.git
2$ cd simple-oidc-client
3$ npm install

then the server is ./src/server.mjs

Use it to debug

• Launch this server
• Replace your relying party by this server. Example with nginx:

1server {
2  listen 443 ssl;
3  listen [::]:443 ssl;
4  ssl_certificate /etc/nginx/my-cert.crt;
5  ssl_certificate_key /etc/nginx/my-cert.key;
6  server_name tmail.client.fr;
7
8  location / {
9    proxy_pass http://localhost:5000;
10    proxy_set_header Host $http_host;
11  }
12}

• Launch your browser and connect to your app. In this example: https://tmail.client.fr/
• Configure OIDC parameters with the values of your relying party and validate
• If it's OK, follow the link and launch OIDC flow, you'll see OIDC data

Command line options

You can use command-line options to configure the OIDC client:

      --help           Show help                                       [boolean]
      --version        Show version number                             [boolean]
  -p, --port           Port to listen on                [number] [default: 5000]
  -i, --issuer         OIDC Issuer URL                                  [string]
  -n, --client-id      OIDC Client ID                                   [string]
  -s, --client-secret  OIDC Client Secret                               [string]
  -r, --redirect-uri   Redirection URI                                  [string]
      --alg            Algorithm                     [string] [default: "RS512"]
      --scopes         Scopes         [string] [default: "openid email profile"]
      --opaque-token   Access token is opaque         [boolean] [default: false]