Syncing Azure Directory with Monitor

This article is for Cloud Admins/Tech Admins.

You can sync your users and groups from your Azure Directory with Monitor. One of the benefits of syncing your Azure Directory is Monitor users will see your users’ names instead of just your users’ system ID. Creating Monitor groups in your directory also ensures Monitor is reporting on your current users, especially as students and staff change throughout the school year.

Plan your groups to support the Alerting Profiles your Safeguarding Contact needs. You can use existing groups and create new groups in your Azure Directory. The synced groups can be used by your Safeguarding Contact to edit and create Alerting Profiles as soon as the first sync is complete. 

Monitor will automatically perform recurring automated syncs after you complete the configuration. You can also complete a manual sync to update Monitor with your current Azure Directory data.

Allowing Access to Azure Directory

You must give Monitor access to your Azure Directory before syncing your data and mapping the groups in Monitor. This process has four steps:

  1. Add a new registration.
  2. Configure permissions.
  3. Copy the secret.
  4. Copy the Client ID and Tenant ID.

1. Add a New Registration

  1. In Azure Directory (, select the top left icon and select Azure Active Directory from the sidebar.
  2. Select App Registrations from the sidebar.
  3. Select New Registration.
  4. Enter a Name.
  5. Check the Accounts in the organisation directory only checkbox. 
  6. Select Register.

2. Configure Permissions

  1. Select API Permissions from the sidebar.
  2. Select Add Permission.
  3. Select Microsoft Graph.
  4. Select Application Permission.
  5. Enter Directory in the search bar.
  6. Expand the Directory arrow and select Directory.Read.All.
  7. Select Add Permission.
  8. Select Grant Admin Consent.
  9. A confirmation window will appear. Select Yes.
  10. The Status will update to Granted with green ticks.

3. Copy the Secret

  1. Select Certificates and Secrets from the sidebar.
  2. Select New Client Secret.
  3. Enter a Description. 
  4. Select Expires in 24 months.


    Add a reminder in your calendar to update the Secret in 24 months.

  5. Select Add.


    Do not navigate away from this page until you have copied the Value, otherwise the Value will be hidden and you will not be able to see it again. You will need to delete and generate a new Secret again.

  6. Copy the ID under the Value column and paste it into a notepad.

4. Copy the Client ID and Tenant ID

  1. Select Overview from the sidebar.
  2. Copy the Application (client) ID and paste it into a notepad.
  3. Copy the Directory (tenant) ID and paste it into a notepad.

Creating and Syncing your Directory


The initial sync can take up to 2 hours depending on the size of your directory. 

  1. Sign in to your Monitor Portal.

    Monitor - UK, Australia, New Zealand

    Monitor - US
  1. From the top-left menu, select Admin Panel > Directories.
  2. Select Add Directory.
  3. Select Azure and select Confirm.
  4. Type a description you will recognise in Name.
  5. If you are multi-tenanted organisation, you can select All tenants or Selected Tenants.
  6. Paste your Client ID (Azure Application ID).
  7. Paste the Client Secret (Azure Client Secret value).
  8. Paste your Azure Tenant ID (Azure Directory ID).
  9. Select Save.

The sync will begin automatically. The “Last Sync Date” will display the time the sync was completed after the sync is complete.

Forcing a Manual Sync

You can manually force a sync if you have made changes within Azure Directory and want it to reflect within Monitor.

  1. Sign into the Monitor Portal.
  2. Go to Admin Panel > Directories.
  3. Click on the Azure Directory you want to sync.
  4. Select Sync Directory at the bottom-left of your window.

After your directories are updated you can map your Azure directories to Groups in Monitor for your Safeguarding Contact to create Alerting Profiles.


Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.