oidc-provider

oidc-provider

oidc-provider is an OpenID Provider implementation of OpenID Connect. It allows to export a complete mountable or standalone OpenID Provider implementation. This implementation does not force you into any data models or persistance stores, instead it expects you to provide an adapter. A generic in memory adapter is available to get you started.

The provided examples also implement simple user interaction views but those are not forced on you as they do not come as part of the exported application, instead you are encouraged to implement your own unique-looking and functioning user flows.

Table of Contents

• 'next' branch/release
• Implemented specs & features
• Get started
• Configuration and Initialization
• Events
• Certification

'next' branch/release

This branch is being kept up to date with the latest release, only having the internal dependencies koa2 based, therefore requiring ES7 async/await capable node runtime (or live transpile). There are no extra features or master-unreleased features. 2.0.0 of this library will come when koa2 releases as latest and when ES7 async/await lands in LTS nodejs release (probably LTSv8).

You can use this library if you already use node stable with --harmony_async_await, just declare your dependency in package.json with the @next distribution tag.

The published versions also use pre-release version scheme 2.0.0-alpha.x.y.z with xyz being the same as the corresponding latest release. i.e. 2.0.0-alpha.1.2.0 is essentially version 1.2.0 only with the updated dependencies.

Implemented specs & features

The following specifications are implemented by oidc-provider. Note that not all features are enabled by default, check the configuration section on how to enable them.

• OpenID Connect Core 1.0 incorporating errata set 1
  • Authorization (Authorization Code Flow, Implicit Flow, Hybrid Flow)
  • UserInfo Endpoint and ID Tokens including
    • Signing - Asymmetric and Symmetric
    • Encryption - Asymmetric and Symmetric
  • Passing a Request Object by Value or Reference including
    • Signing - Asymmetric and Symmetric
    • Encryption - Asymmetric using RSA or Elliptic Curve
  • Public and Pairwise Subject Identifier Types
  • Offline Access / Refresh Token Grant
  • Client Credentials Grant
  • Client Authentication via (client_secret_basic, client_secret_post, client_secret_jwt or private_key_jwt)
• OpenID Connect Discovery 1.0 incorporating errata set 1
• OpenID Connect Dynamic Client Registration 1.0 incorporating errata set 1
• OAuth 2.0 Form Post Response mode
• RFC7636 - Proof Key for Code Exchange by OAuth Public Clients
• RFC7009 - OAuth 2.0 Token revocation
• RFC7662 - OAuth 2.0 Token introspection

The following drafts/experimental specifications are implemented by oidc-provider.

• OpenID Connect Session Management 1.0 - draft 27
• OpenID Connect Back-Channel Logout 1.0 - draft 03
• RFC7592 - OAuth 2.0 Dynamic Client Registration Management Protocol (Update and Delete)
• OAuth 2.0 for Native Apps BCP - draft 06

Updates to drafts and experimental specification versions are released as MINOR library versions.

Get started

To run and experiment with an example server, clone the oidc-provider repo and install the dependencies:

$ git clone -b next https://github.com/panva/node-oidc-provider.git oidc-provider
$ cd oidc-provider
$ npm install
$ node --harmony_async_await example

Visiting http://localhost:3000/.well-known/openid-configuration will help you to discover how the example is configured.

This example is also deployed and available for you to experiment with here. An example client using this provider is available here (uses openid-client).

Otherwise just install the package in your app and follow the example use. It is easy to use with express too.

$ npm install oidc-provider@next --save

1.0.0 Notice

Migrating from 0.11.x release? Quite a bit has changed along the way to end up with a stable and sustainable API, see the CHANGELOG for list of changes and how to change your existing 0.11 providers to 1.0

Configuration and Initialization

oidc-provider allows to be extended and configured in various ways to fit a variety of uses. See the available configuration.

const Provider = require('oidc-provider').Provider;
const issuer = 'http://localhost:3000';
const configuration = {
  // ... see available options /docs/configuration.md
};
const clients = [  ];

const oidc = new Provider(issuer, configuration);
oidc.initialize({ clients }).then(function () {
  console.log(oidc.callback); // => express/nodejs style application callback (req, res)
  console.log(oidc.app); // => koa1.x application
});

Events

Your oidc-provider instance is an event emitter, using event handlers you can hook into the various actions and i.e. emit metrics or that react to specific triggers. In some scenarios you can even change the defined behavior.
See the list of available emitted event names and their description.

Certification

OpenID Certified™ by Filip Skokan to the OP Basic, OP Implicit, OP Hybrid, OP Config and OP Dynamic profiles of the OpenID Connect™ protocol.