User Syncing with Azure Active Directory

Connect your environment’s people data to Azure Active Directory


In order for the integration to work, Simpplr requires consent provided by the Azure Global Admin user. Then the Group Admin user must connect with their credentials. The Group Admin is required in order to read user profile data from the Azure Admin. Once the Global Admin connection is established, the Global Admin user can remove the Global Admin permission from the account if they wish and connect again using an account that has all the permissions listed below. The Global Admin connection is only required temporarily to approve the consent for the integration as some of these permissions can not be granted unless a Global Admin approves the same.

We recommend resetting the Admin user's password every few months for added security. Changing the admin connection password will not affect the integration or any user access in any way on Simpplr.


Users who are the Active Directory Global Admins and have Salesforce System admin access can complete the instructions below to select Azure Active Directory as the source for Simpplr's people data.

To be able to sync users' data and fields on Simpplr, Simpplr needs to read certain data of users in the organization, hence we request for the User.Read.All scope (this is the least privileged scope).

The User.Read.All permission allows Simpplr to read all users' full profiles, which include sets of profile properties, reports and managers of users in your organization.

From an application standpoint, User.Read.All is the least privileged permission. Since the app needs to read users' data from Microsoft Graph, Microsoft mandates admin consent to be provided for the application only can be granted using the Global Admin user. As mentioned above, once the Global Admin consent has been provided, the user can remove the permission from the account.

The image below highlights which permissions require Global Admin consent, and what user data is being pulled from Microsoft to Simpplr. These permissions must be granted by the Global Admin user.

  1. As the Admin user, in Simpplr, go to Manage > Application > Integrations > People Data.
  2. Select the Active Directory checkbox to connect using admin credentials. You will be asked to accept the requested permissions as shown below.
  3. After signing into the source account with admin credentials, your source account will be connected and you'll be redirected back to Simpplr.




Set up Active Directory user attribute syncing

Back to top

If your environment is connected to Azure Active Directory, System admins will be able to sync user attributes from Azure Active Directory:

  1. Go to Manage App > People > User Syncing.
  2. Select Active Directory as the syncing source.
  3. Select which fields you want to sync between Azure Active Directory and Simpplr. 
  4. To sync user people data, run ScheduleSimpplrServices. This job is pre-scheduled to run once a day, but can be run on-demand.


selecting fields to sync between Azure Active Directory and Simpplr

Batch sync and provision Simpplr people data with Azure Active Directory

Back to top

Once your environment is connected to Azure Active Directory, and Active Directory is selected as the People data source, System admins are ready to batch sync and/or provision People data in Simpplr with Active Directory's source data:

  1. Go to Manage App > Setup > Schedulers.
  2. To provision users on-demand, run ScheduleHourlySimpplrServices. This job is pre-scheduled to run every three hours, but can be run on-demand.
  3. To sync user people data on-demand, run ScheduleSimpplrServices. This job is pre-scheduled to run once a day, but can be run on-demand.
  4. Simpplr People data will be automatically synced or provisioned accordingly.


options for a batch job under Schedulers


Changes in Simpplr app

  1. Log in to your Simpplr app as the System administrator.
  2. Go to Manage > Application > People. Select User syncing and scroll down to the Hire date field. Check the box.
  3. Click Save.
  4. The data will sync within 24 hours on Simpplr.
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request



Please sign in to leave a comment.

Articles in this section

See more