How to configure SSO integration with Azure Active Directory

How to configure SSO integration with Azure Active Directory

What is the issue you're facing?

I would like to use SSO with Market Dojo and Azure Active Directory. How do I do this?

Solution

What does Azure Active Directory do?

Azure is Microsofts Cloud. Active Directory allows organisations to administer security centrally. 

By integrating with Azure, users can sign on to Market Dojo using their Microsoft credentials. It helps IT teams to manage which users have access and is helpful when people join or leave their organisation.

The rest of this guide explains how to use Azure Active Directory with Market Dojo.


Configure Azure Active Directory

First of all, ensure that you have an Azure account.


  1. Go to your companies Microsoft Azure Portal

  2. Find the 'App Services', 'Manage Azure Active Directory' option and click 'View'

  3. Click 'App Registrations' and add a new registration

  4. Make a note of the Application and Directory IDs

  5. Click on the 'Certificates and Secrets' option

  6. Create a New Client Secret, make a note of the secret

  7. Back on the overview page, edit redirect URLS and add a url with the following format:
    https://<HOST>/omniauth/azure_oauth2/callback
    (where <HOST> is the whitelabelled URL of the Market Dojo application e.g. https://mycompany.marketdojo.com/omniauth/azure_oauth2/callback)


Configure Azure

  • Make any other changes to Azure Active Directory Registration which are required by your company


Configure Market Dojo
  • Login to your Market Dojo account 

  • Go to the Admin>Integrations page

  • Click +Microsoft Azure Active Directory, and enter the settings you noted in the previous step


Test this integration
  • Logout of Market Dojo

  • Go to the login page (be sure to use your white label URL)

  • You should see an option ‘Sign in with Microsoft Active Directory, click it

  • If everything is configured correctly, you will be logged in