Active Roles 8.1.1 - Synchronization Service Administration Guide

To configure an Azure application for a Microsoft Azure Active Directory connection

1. 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. To run the script, you need to install Microsoft Azure PowerShell on your computer.

   Script example

   # 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 'Company Administrator'}).ObjectId
   
   # Assign the required permissions to the Active Roles Azure AD Connector Application
   
   Add-AzureADDirectoryRoleMember -ObjectId $roleId -RefObjectId $servicePrincipal.ObjectId

2. Open the application properties and copy the following information:

   • Client ID

   • Valid key of the application

   Supply the copied client ID and application key when creating a new Microsoft Azure Active Directory connection or modifying an existing one in the Synchronization Service Console.

To create a new connection

1. In the Synchronization Service Console, open the Connections tab.
2. Click Add connection, then use the following options:
   • Connection name: Type a descriptive name for the connection.

   • Use the specified connector: Select Microsoft Azure AD Connector.

3. Click Next.

4. On the Specify connection settings page, use the following options:

   • Azure AD domain: Specify the name of any domain in the Microsoft Azure Active Directory environment you want to manage with Synchronization Service.

   • Client ID: Enter the client ID you copied in Open the application properties and copy the following.

   • Key: Enter the application key you copied in Open the application properties and copy the following.

   • Test Connection: Click this button to verify the specified connection settings.

5. To finish creating the connection to Microsoft Azure Active Directory, click Finish.