SSO Setup

The Admin Portal manages Single Sign-On (SSO) via Auth0, which simplifies the authentication process for our clients and allows us to integrate via a variety of SSO providers.

Overview

Auth0 allows us to create enterprise connections, which enable users to log in using their company's identity provider (IdP).

Currently, we support all enterprise connection methods supported by Auth0, the two most popular ones being SAML and OIDC. Both of which are very easy to set up.


Role Mapping

There are three roles available for user mapping:

RoleDescription
readyremit_adminAdmin
readyremit_financeFinance
readyremit_csrCSR

Connection Setup

SAML

Information We Provide

Brightwell will provide the following details for both sandbox and production environments:

FieldValue
Identifierurn:auth0:readyremit:<connection-name>
Reply URLhttps://login.brightwell.com/login/callback?connection=<connection-name>
Logout URLhttps://login.brightwell.com/logout

Information We Receive

Customers will provide:

  • A login URL
  • An x509 certificate These are used to create the enterprise connection in Auth0.

Post-Connection Steps

  1. Enable Home Realm Discovery on the connection and set the URL.
  2. In the Applications tab, enable the following for the target environment:
    • Brightwell SPA app

OIDC

Information We Receive

Customers provide an OIDC discovery URL. We use this to create the enterprise connection and then inspect the JSON response from the URL to determine whether the requested scopes need to be updated to include the scope for the user role.

Information We Provide

Provide the customer with the following details for both sandbox and production environments:

FieldValue
Reply URLhttps://login.brightwell.com/login/callback
Logout URLhttps://login.brightwell.com/logout

Note: The Reply URL for OIDC does not require a connection query parameter.