With the Microsoft 365 connector, you can configure data synchronization connections for the Microsoft 365 service.
You can create an M365 connector by configuring an Azure application in the :
With the Microsoft 365 connector, you can configure data synchronization connections for the Microsoft 365 service.
You can create an M365 connector by configuring an Azure application manually in the . One Identity recommends using Manual configuration if you want to use an existing Azure application for the connection.
IMPORTANT: If you are upgrading from an older version of Active Roles to Active Roles 8.1.3 or later, and the connector was configured manually, then you must update the authentication data to be able to run a synchronization workflow.
To update the authentication data, you can:
To create a new M365 connector with manual configuration
-
In the , open the Connections tab.
-
Click Add connection, then use the following options:
-
Click Next.
-
To use an existing Azure application, select Manual configuration.
NOTE: Alternatively, to use and update an existing Azure application, you can also select Auto configuration. Under Auto configuration, click Log in to Azure, then select the Tenant environment type of the Azure tenant. After logging in to Azure with your tenant, the Tenant ID, Application ID, Certificate thumbprint and Tenant environment type parameters will be automatically filled in.
-
Enter the Tenant ID, Application ID and Certificate thumbprint of the Azure tenant as they appear on the Azure portal. Then, select the Tenant Environment Type of the Azure tenant.
-
To test the connection with the new parameters, click Test connection.
-
To finish creating a connection to Microsoft 365, click Finish.
With the Microsoft 365 connector, you can configure data synchronization connections for the Microsoft 365 service.
You can create an M365 connector by configuring an Azure application automatically in the . One Identity recommends using Auto configuration if you want to create a new Azure application for the connection.
Prerequisites
To create, consent and delete Azure AD applications for Active Roles , the user account performing the procedure must have the following permissions:
To create a new M365 connector with automatic configuration
-
In the , open the Connections tab.
-
Click Add connection, then use the following options:
-
Click Next.
-
To create a new Azure application or update an existing one, select Auto configuration.
NOTE: If you have more than one Azure Active Directory (Azure AD) service in your Azure tenant, select I have more than one Azure AD in my Azure tenant, and use the Tenant ID field to specify the GUID of the Azure AD for which you want to set up synchronization. For more information, see Finding the GUID (Tenant ID) of an Azure AD for Azure BackSync.
-
Select one of the following options based on the number of Azure AD services in your Azure tenant:
-
Authenticate your access to Azure AD:
-
If you have selected I have one Azure AD in my Azure tenant, to authenticate your access to Azure AD, click Log in to Azure, and from the Select Environment Type drop-down, select the environment type of your Azure tenant.
NOTE: Active Roles supports Azure Cloud, Azure GCC and Azure GCC-H government tenants.
-
If you have selected I have more than one Azure AD in my Azure tenant, in Tenant ID, enter the GUID of the Azure AD for which you want to set up synchronization.
After specifying the tenant ID, to authenticate your access to Azure AD, click Log in to Azure, and in the Select Environment Type drop-down, select the environment of your Azure tenant.
NOTE: If you select I have more than one Azure AD in my Azure tenant, the Log in to Azure button will be enabled only if you specify a well-formed Azure AD GUID in the Tenant ID text box.
You can now create or update the Azure application in Azure AD.
-
Azure application name: Enter the name of the new or existing Azure application.
-
To create or update the Azure application in Azure AD, click Create or update Azure application.
The created or updated Azure application has the following directory roles assigned to it:
-
Directory Writers
-
Exchange Administrator
-
User Administrator
The following permissions are also added, for which you must give admin consent:
NOTE: You may need to set additional permissions depending on your needs, or remove permissions later if the Azure AD app is no longer used. To add additional permissions to the Azure application or remove any of them, sign in to the Azure Portal, then under Microsoft Entra ID > Manage > Roles and Administrators, manage the currently assigned roles of the app.
-
To give admin consent for the permissions of the Azure application, click Consent. Then, in the Azure Tenant Consent dialog, click Accept.
-
To test the connection with the new parameters, click Test connection.
-
To finish creating a connection to Microsoft 365, click Finish.
With the Microsoft 365 connector, you can configure data synchronization connections for the Microsoft 365 service.
You can modify the settings of an existing M365 connector in the :