Skip to main content

Azure AD

Discover step-by-step instructions on configuring a Directory Sync with Azure AD. Learn how to integrate your application with Azure AD.

Declare an application

Directory screen

Click on "Enterprise applications" in the left sidebar.


Enterprise Applications screen

Then, on the new screen, click on "New application."


Own application screen

Click on "Create your own application."


Own application screen
  1. Choose a name for your app.
  2. Select "Integrate any other application you don’t find in the gallery (Non-Gallery)."
  3. Click on "Create"

Configure your application with the supplied identification elements

Provisioning Button

Go to the "Provisioning" section.


Provisioning Button

In the new window, select "Provisioning" again.


Provisioning Mode Menu

In the "Provisioning Mode" menu, select "Automatic."


Admin Credentials

In Admin Credentials, fill in the following

  1. In the "Tenant URL" field, paste the "SCIM Endpoint" value that you find on the right side of this tutorial 👉

  2. In the "Secret Token" field, paste the "Secret Token" value that you find on the right side of this tutorial 👉

Edit Mappings

Directory screen

Click on "Attribute mapping (Preview)" in the left sidebar.


Directory screen

Click on "Provision Microsoft Entra ID Users".


Directory screen

Click on "Edit" at the right of the "userName" attribute.


Directory screen
  • In "Source attribute" replace "userPrincipalName" by "mail".
  • Click on "Ok" at the bottom.
  • NOTE: We need to receive the emails that users use. So depending on your AD this could be the UPN or the mail.

Directory screen

Now edit the external ID mapping by clicking "Edit" at the right of "externalId" attribute.


Directory screen
  • In "Source attribute" replace "mailNickname" by "objectId".
  • Click on "Ok" at the bottom.

Directory screen
  • At the top of the page click on "Save".
  • Then click "Yes" to validate the changes.

Admin Credentials

Test your app's synchronization by assigning users to this application.