Skip to main content
Single sign-on (SSO) lets your team members authenticate their access to the Mangopay Dashboard via a third-party identity provider. Setting up SSO can help simplify access management and increase security by enforcing standards.
Note - Enabling SSO replaces previous credentialsIf you decide to set up SSO, Mangopay Dashboard users will no longer be able to authenticate using their previously created passwords.
Prerequisites
  • An Azure account with an active subscription
  • Microsoft Entra ID as your identity provider
  • Mangopay registered as an application in your Microsoft Entra ID account (for more information, see the Microsoft Quickstart guide)

​
1. Configure Microsoft Entra ID for Mangopay

In Microsoft Entra ID, go to Applications > Identity > Applications > Enterprise applications > All applications:
  • Search for and select the Mangopay app.
  • Assign the users or groups that will be able to log in to Mangopay.
In the left navigation pane, select App registrations. In App registrations, select your Mangopay app, go to the Overview menu:
  • Note the Application (client) ID for the next step.

​
2. Retrieve your Client Secret and Client Secret Token

In your Mangopay app registration, go to the Certificates & secrets menu and then the Client secrets tab:
  • Create a new Client Secret.
  • Note the Client Secret Token for the next step.
Caution – Client Secret Token expires after 24 monthsOnce the Client Secret Token expires, you will no longer be able to connect to your application using the Entra ID SSO. You will have to generate a new token and contact Mangopay to regain access.

​
3. Retrieve your Microsoft Entra ID domain

To find your Microsoft Entra ID domain:
  1. Sign in to the Microsoft Azure portal.
  2. On the Microsoft Entra ID Overview page, scroll through the Basic information section to find Primary domain.
For more information on locating important IDs, see the following Microsoft article.

​
4. Contact Mangopay

Contact the Mangopay Support team via the Dashboard. Set the subject as:
  • Microsoft Entra ID SSO activation
In the description, make sure to include the following information:
  • Microsoft Entra ID domain (example.onmicrosoft.com)
  • Microsoft Entra ID Client ID
  • Microsoft Entra ID Client Secret Token

​
5. Await confirmation to coordinate switchover

When Mangopay activates the Microsoft Entra ID SSO for your application, you will receive a confirmation email.

​
6. Instruct your users to log in with Microsoft Entra ID

On the Dashboard login screen, your users will see a button prompting them to log in with Microsoft Entra ID.