Knowledge Base Article

SSO Identity provider for JWT based on Node JS [Linux] or [Windows]

This article is going to walk you through and provide basic overview how to implement SSO IDP for JWT authentication into Sisense.

Plugin Location Folder

Similar to any Node JS projects, this particular project also contains a couple of folders, and below you would be able to find the basic overview  

  • index.js (Where the main logic is defined for SSO Identity Provider)
  • .env (File contains optional 2 parameters for port and secret, you could define either in .env or index.js 2 values)

GETTING STARTED (Installation Steps)

To begin, upload and unzip the folder and navigate to your ssoIDP directory.

Please follow the steps below for further installation:

  1. Please ensure you have npm installed, with the command: npm –version , in case npm is not installed, follow any guide for installation online

  2. Run below commands:
    npm init -y
    npm install express jsonwebtoken dotenv

  3. Once all dependencies are installed, before starting the NPM server, ensure you have correctly defined values in index.js  (Image at the top of the page)
    Where Line #12 user under which you are going to log in to Sisense
    Where Line #15 requires you to match your sharedSecret from Sisense, under Admin -> SSO
    Where Line #16 your Sisense URL

  4. Once all values are defined and saved, run:
    node index.js

  5. In Sisense under Admin -> SSO -> JWT -> Remote Login URL, define your https://localhost:3000/login so each time you try to log in, it would redirect to your IDP

  6. Successfully logged

Disclaimer: This post outlines a potential custom workaround for a specific use case or provides instructions regarding a specific task. The solution may not work in all scenarios or Sisense versions, so we strongly recommend testing it in your environment before deployment. If you need further assistance with this, please let us know.

Published 07-09-2025
No CommentsBe the first to comment