Configure SSO Access to Bringg

Set up Single Sign-On (SSO) access to add a layer of security and enable users to log in using the same credentials that they use for your other management systems, through your IdP's app dashboard. Bringg provides all the account details you need to integrate with your Identity Provider (IdP), so you can set up SSO and get your users online quickly.

Users can also log in to the Bringg Platform directly by entering their email and password directly into Bringg's login page.

Figure 1. Enable SSO Identity Verification

Before You Begin

Confirm you have a Bringg user of type Admin.

Procedure

Select your username > Settings > Platform Integrations > SSO Configuration
Figure 2. Access the SSO settings

Integrate Bringg to your Identity Provider (IdP) using the data that Bringg provides.

To copy this information, select the Copy SSO URL and Copy Audience URL when your IdP requests that you enter each.

Figure 3. Copy SSO data from Bringg

There are a number of SSO providers on the market. Most share the same terminology, but it does vary.

Field	Description
SSO URL	This is where your IdP sends authentication data when you sign in. Also known as: ACS URL
Audience URI	This URI (Uniform Resource Identifier) is how your IdP confirms that a request for access is coming from Bringg. Also known as: SP Identity ID

Field

Description

SSO URL

This is where your IdP sends authentication data when you sign in.

Also known as: ACS URL

Audience URI

This URI (Uniform Resource Identifier) is how your IdP confirms that a request for access is coming from Bringg.

Also known as: SP Identity ID

Configure your IdP to send user details to Bringg.

This is often described as claims or attributes in your IdP.

Field	Description
first name, last name	Bringg uses this as the user's display name.
email	Bringg uses this as the user's username.
teams	(Optional) Use to automatically assign the new user to one or more teams. Use your IDs for teams.
dispatcher	(Optional) Usually set as a default so any new user is a dispatcher user type unless specified otherwise.
admin	(Optional) Use to assign new users with an admin user type.
driver	(Optional) Use to assign new users with a driver user type.
privilege ID	(Optional) Use to grant the new user access to certain screens and actions, that differ from the default set of permissions.

Enter the details provided by your IdP.

Figure 4. Enter your SSO identification data

Field	Description
IdP Single Sign-On (SSO) Target URL	(Coming soon) This is the URL that Bringg redirects you to so you can login to your IdP (coming soon). Also known as: Login URL
IdP Entity ID	This is the data that tells Bringg where the request for access is coming from. Also known as: Provider ID
IdP Cert Fingerprint-SHA 256	This is how Bringg authenticates that the request for access is coming from your IdP. If your IdP provides you with a X.509 public certificate instead of its abbreviated fingerprint, you can convert it using the fingerprint calculator. Figure 5. Convert X.500 public certificate using a fingerprint calculator Also known as: Signing Certificate Fingerprint
Single Logout (SLO) Target URL	(Optional) This is how Bringg ends your IdP session when you sign out of Bringg. Use this if you want users to be logged out from Bringg when they log out from your IdP.
Privilege	When you create new users through your IdP, they are automatically assigned the dispatcher user type, which is the most basic access level. Choose the set of privileges to assign these new users to limit or grant access to additional features and actions in the platform. If needed, you can then update their user type in Bringg to assign admin permissions. Learn more.Add a Bringg User

Select Save to activate SSO.
Figure 6. Save to implement SSO
Test your SSO configuration to make sure it is active.
To do this, copy the URL provided and paste it into a browser that does not have your login information stored, such as an incognito browser. Then, log in to Bringg using your SSO.
If you are not able to access Bringg using SSO, or you are not redirected to your IdP's login page, check to make sure that all fields are filled correctly, and contact your Bringg customer service representative if the error persists.
Figure 7. Copy URL to login to Bringg via your IdP
Instruct your users to log in to the Bringg Platform using SSO.
- Users can log in from your IdP's app dashboard by selecting Bringg from the list of apps and services that use your IdP for authentication.
- Users can also access your IdP's authentication page for Bringg with a merchant specific URL.
  Select Copy this URL and instruct your users to bookmark the URL and use it to log in to Bringg.