Synchronization Service reads and writes data in Microsoft Azure Active Directory by using an application existing in your Microsoft Azure Active Directory environment. This step describes how to configure such an application.
To configure an application
- Create an application in any domain of your Microsoft Azure Active Directory environment. The application must have sufficient permissions to read and write data in Microsoft Azure Active Directory.
You can assign the required permissions to the application by running a Windows PowerShell script. Below is an example of such a script. To run the script, you need to install Microsoft Azure PowerShell on your computer.
# Replace <ClientId> with the Client ID of the Active Roles Azure AD Connector Application (example format: 455ad643-332g-32h7-q004-8ba89ce65ae26)
$Id = “<ClientId>”
# Prompt for Microsoft Azure AD Global Admin credentials.
# Save the supplied credentials to the $creds variable.
$creds=get-credential
# Connect to Azure AD using the credentials stored in $creds.
Connect-AzureAD -credential $creds
# Get the Principal ID of the Active Roles Azure AD Connector Application and save it to the $servicePrincipal variable
$servicePrincipal = Get-AzureADServicePrincipal -All $true | Where-Object {$_.AppId -eq $Id}
# Get the required role ID from the Active Roles Azure AD Connector Application and save it to the $roleId variable
$roleId = (Get-AzureADDirectoryRole | Where-Object {$_.displayName -eq 'Directory Writers'}).ObjectId
# Assign the required permissions to the Active Roles Azure AD Connector Application
Add-AzureADDirectoryRoleMember -ObjectId $roleId -RefObjectId $servicePrincipal.ObjectId
- Open the application properties and copy the following:
- Client ID
- Valid key of the application
You need to supply the copied client ID and key when creating a new or modifying an existing connection to Microsoft Azure Active Directory in the Synchronization Service Administration Console.