Exciting release!Introducing "safe npm". Learn more
Log inDemoInstall


Package Overview
File Explorer

Advanced tools


OpenID Connect provider plugin for @luigi-project/core


Version published
Weekly downloads
increased by56.45%

Weekly downloads



[v2.0.1] (2023-02-14)

:bug: Fixed
  • #3180 fix multi alert promise (@hardl)
  • #3179 fix backdrop overlay (@hardl)



OpenID Connect - Authorization Plugin for Luigi Core


This authorization plugin 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.


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');


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.

Next, you must install oidc-client in your project as a dev dependency:

npm i -save-dev oidc-client

Then, you need to copy certain auxiliary plugin files and the callback file, as they are needed for the initial setup.

Respectively from oidc-client library you need:

  • oidc-client.min.js which normally resides in node_modules/oidc-client/dist

and from our library @luigi-project/plugin-auth-oidc you need:

  • plugin.js
  • silent-callback.html
  • plugin-ie11.js (for IE11 only) which all reside under node_modules/@luigi-project/plugin-auth-oidc/plugin.js.

The above mentioned files should be copied to assets/auth-oidc as the default location.

Below we give some alternatives on how to easily copy these files in your project. However, you may choose your own way of copying these files depending on your environment.

For applications involving a webpack configuration, one way to copy files is using packages such as copy-webpack-plugin and then including the following in your webpack configuration file:

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' } ]) ] }

If your application does not use webpack or you installed Luigi without a framework, you can use an alternative way of copying the silent-callback.html file. You can use any copy plugin to copy the file and then modify the package.json script to copy the file when building. One package that could be helpful is copyfiles. Below is an example:

"buildConfig": "webpack --entry ./src/luigi-config/luigi-config.es6.js --output-path ./public/assets --output-filename luigi-config.js --mode production", "build": "npm run buildConfig && npm run copyCallbackOIdc", "copyCallbackOidc": "copyfiles -f node_modules/@luigi-project/plugin-auth-oidc/silent-callback.html node_modules/@luigi-project/plugin-auth-oidc/plugin.js node_modules/@luigi-project/plugin-auth-oidc/plugin-ie11.js node_modules/oidc-client/dist/oidc-client.min.js public/assets/auth-oidc"

Running npm run build should then suffice to bundle the config and also copy the callback file.



Last updated on 14 Feb 2023

Did you know?

Socket installs a Github app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install Socket
support@socket.devSocket SOC 2 Logo


  • Package Issues
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc