auth0-extensions / auth0-sso-dashboard-extension

46 stars 34 forks source link

Auth0 SSO Dashboard Extension

CircleCI Maintainability Test Coverage

Running in Production

npm install
npm run client:build
npm run server:prod

Running in Development

Update the configuration file under ./server/config.json:

{
  "EXTENSION_CLIENT_ID": "client id of my app",
  "WT_URL": "http://localhost:3000/",
  "PUBLIC_WT_URL": "https://localhost:3000/",
  "AUTH0_RTA": "https://auth0.auth0.com",
  "AUTH0_DOMAIN": "me.auth0.com",
  "AUTH0_CLIENT_ID": "client id of my api client",
  "AUTH0_CLIENT_SECRET": "client secret of my api client"
}

There should be 2 clients. One (first) - "Single page application" with only necessary connection enabled and 'RS256' algorithm (advanced settings). Second (management client) - "Non Interactive" with scopes "read:clients update:clients read:connections read:users read:logs read:device_credentials".

Then you can run the extension:

npm install
npm run serve:dev

Custom Style

Customers can choose to implement their custom style, to do so the following settings can be added:

{
  "TITLE": "Fabrikam SSO Dashboard",
  "CUSTOM_CSS": "https://cdn.jsdelivr.net/gh/auth0-extensions/auth0-sso-dashboard-extension@master/docs/theme/fabrikam.css"
}

The CSS file has to be hosted by the customer and can be used to change the style of every component. An example can be found under docs/theme.