App Info

Sync Clients From Your Microsoft Azure Portal Last updated: Aug 23, 2021

1. Navigate to Azure Portal (https://portal.azure.com) and open Azure Active Directory.



2. On the left navigation menu, click App Registrations.

3. Next click + New Registration from the top of the page.

4. Now you can enter the name of your application and select whether your app is Single-tenant or Multitenant app.  If you are unsure, it's most likely Single-tenant, but check with your Office 365 admin.  Then hit Add

5. You are now on the' Overview' page as you now have the app registration created. Copy your Application (client) ID and Directory (tenant) ID; You will need them later.

6. You will need to create the 'Client secret' for your registered app.

  • Click 'Certificates & secrets' from the left menu
  • Click the '+New client secret' button.
  • Select how long your secret is valid.
  • Click the 'Add' button.
  • Copy the Secret, you will need it later. If you do not copy the secret now, you will have to do step 6 again as you will not be able to see it again.

7. We now have to make sure we have the appropriate permissions to sync users. Click API permissions on the left navigation.

  • Click +Add a permission
  • Select Microsoft Graph
  • Select Application Permission
  • Now, scroll down to User and check the box next to the permission User.Read.All
  • Select the blue Add permission button at the bottom of the window to save the selection
  • Finally, click the 'Grant admin consent for Organization' button, and select the blue Yes button to save changes.

8. Head over to Vertask Azure User Sync. (You must be a superuser in Vertask to do this.)

9. Set the status to enabled and specify and sync frequency. 

10. Enter the Application (client) ID, Tenant ID, and Client secret you previously created.

11. Select if you want to sync external users from your Azure environment and whether you want to invite users to the client portal when they are synced.

12. Once all settings are correct, click the Save Changes button

13. At the top of the page, click Microsoft Azure

14. If you want to sync users immediately, or if you picked manual sync for the sync frequency, click the 'Sync users now' button.