@luigi-project/plugin-auth-oidc

OpenID Connect provider plugin for @luigi-project/core

Usage no npm install needed!

<script type="module">
  import luigiProjectPluginAuthOidc from 'https://cdn.skypack.dev/@luigi-project/plugin-auth-oidc';
</script>

README

OpenID Connect - Authorization Plugin for Luigi Core

Overview

This project contains a library that allows your application to extend the Luigi framework with an OpenID Connect authorization provider. Further configuration details can be found in the main documentation. We support Authorization Code with PKCE and Implicit Grant flow.

Installation

Install the plugin in your project using npm:

npm install @luigi-project/plugin-auth-oidc

Import the plugin in places where you want to use it, depending on the environment of your choice:

var OpenIdConnect = require('@luigi-project/plugin-auth-oidc');

or

import OpenIdConnect from '@luigi-project/plugin-auth-oidc';

Then, integrate it as an authorization provider in your Luigi configuration file:

Luigi.setConfig({
  auth: {
    use: 'myProviderConfig',
    myProviderConfig: {
      idpProvider: OpenIdConnect,
      authority: 'http://authority.server',
      logoutUrl: 'http://authority.server/connect/endsession',
      scope: 'openid profile email',

      // for PKCE flow
      client_id: 'authorisation-code-pkce-mock-client', // example oidc-mockserver client id
      response_type: "code", // for PKCE
      response_mode: "fragment", // change between `query` and `fragment`

      // for implicit grant flow
      // client_id: 'implicit-mock-client', // example oidc-mockserver client id

      // ... further configuration data comes here
    }
  }
})

If you want to use the silent token renewal feature, the silent-callback.html needs to be copied to a folder in your Luigi Core installation, which is the return path for the IdP provider, configured through the redirect_uri setting. The default location of redirect_uri is /assets/auth-oidc/silent-callback.html. You must install oidc-client in your project as a dev dependency:

npm i -save-dev copy-webpack-plugin

Then, you need to import the plugin files and oidc-client library in your project using webpack:

const CopyWebpackPlugin = require('copy-webpack-plugin');

{
  plugins: [
    new CopyWebpackPlugin([
     {
         from: 'node_modules/@luigi-project/plugin-auth-oidc/plugin.js',
         to: 'assets/auth-oidc'
     },
     {
         from: 'node_modules/@luigi-project/plugin-auth-oidc/plugin-ie11.js',
         to: 'assets/auth-oidc'
     },
     {
         from: 'node_modules/@luigi-project/plugin-auth-oidc/silent-callback.html',
         to: 'assets/auth-oidc'
     },
     {
         from: 'node_modules/oidc-client/dist/oidc-client.min.js',
         to: 'assets/auth-oidc'
     }
    ])
  ]
}