Active Roles supports the following external data systems with built-in connectors:
NOTE:
Due to limitations in Graph API that prevent creating Azure contacts in Azure AD, cannot synchronize Azure contacts from any source data system to Azure AD.
Depending on the source data system, attempting to synchronize Azure contacts to Azure AD can result in the following error messages:
-
If the source data system is Active Roles:
An error occurred: "A parameter cannot be found that matches parameter name '<attribute>."
-
If the source data system is not Active Roles:
Error: "Unexpected error."
This section describes how to create or modify a connection to Active Directory so that could work with data in that data system.
To create a connection to Active Directory domain, you need to use in conjunction with a special connector called Active Directory Connector. This connector is included in the package.
The Active Directory Connector supports the following features:
Table 2: Active Directory Connector – Supported features
Bidirectional synchronization
Specifies whether you can both read and write data in the connected data system. |
Yes |
Delta processing mode
Specifies whether the connection can process only the data that has changed in the connected data system since the last synchronization operation. This reduces the overall synchronization duration. |
Yes |
Password synchronization
Specifies whether you can synchronize user passwords from an Active Directory (AD) domain to the connected data system. |
Yes |
The Active Directory Connector supports linked attributes existing in the Active Directory schema. Linked attributes allow you to establish associations between two objects.
Linked attributes exist in pairs, as follows:
-
Forward link attribute: This is a linked attribute that exists on a source object (for example, the member attribute on the Group object). Forward link attributes can be single-valued or multivalued.
-
Back link attribute: This is a linked attribute that can be specified on a target object (for example, the memberOf attribute on the User object). Back link attributes are multivalued and they must have a corresponding forward link attribute. Back link attributes are not stored in Active Directory. Rather, they are calculated based on the corresponding forward link attribute each time a query is issued.
To create a new connection
-
In the , open the Connections tab.
-
Click Add connection, then use the following options:
-
Click Next.
-
On the Specify connection settings page, use the following options:
-
Any available domain controller in the specified domain: Allows you to connect to an available domain controller in the Active Directory domain you specify. In the Domain text box, type the fully qualified domain name of the domain to which you want to connect.
-
Specified domain controller: Allows you to connect to a specific domain controller in a particular Active Directory domain. In the Domain controller text box, type the fully qualified domain name of the domain controller to which you want to connect.
-
Active Directory forest: Allows you to connect to the Active Directory forest you specify in this option. When synchronizing data to or from a connected forest, automatically selects the appropriate domain controllers in the forest to read and write data according to the synchronization scope configured for the connection.
-
To test the connection with the new parameters, click Test connection.
-
Click Finish to create a connection to Active Directory.
To modify connection settings
-
In the , open the Connections tab.
-
Click Connection settings below the existing Active Directory connection you want to modify.
-
On the Connection Settings tab, click Specify connection settings to expand it and use the following options.
-
Any available domain controller in the specified domain: Allows you to connect to an available domain controller in the Active Directory domain you specify. In the Domain text box, type the fully qualified domain name of the domain to which you want to connect.
-
Specified domain controller: Allows you to connect to a specific domain controller in a particular Active Directory domain. In the Domain controller text box, type the fully qualified domain name of the domain controller to which you want to connect.
-
Active Directory forest: Allows you to connect to the Active Directory forest you specify in this option. When synchronizing data to or from a connected forest, automatically selects the appropriate domain controllers in the forest to read and write data according to the synchronization scope configured for the connection.
-
To test the connection with the new parameters, click Test connection.
-
Optionally, you can narrow the number of objects participating in the connection scope by setting up filter conditions. On the Connection Settings tab, click the Advanced item to expand it, and then use the following list columns:
-
Object type: Use this column to select the Active Directory object types for which you want to configure filter conditions: click Add Object Type to add an object type to the list. Once you have added an object type, use the Filter condition column to specify a condition the objects of that type must meet in order to participate in the connection scope.
-
Filter condition: Use this column to specify a filter condition for the corresponding Active Directory object type. To specify a filter condition, type an LDAP query. The Active Directory objects that meet the specified filter condition will participate in the connection scope. When no filter condition specified for an object type, all objects that belong to that type participate in the connection scope.
-
When you are finished, click Save.