Chat now with support
Chat with Support

Active Roles 8.1.3 - Synchronization Service Administration Guide

Synchronization Service overview Deploying Synchronization Service Deploying Synchronization Service for use with AWS Managed Microsoft AD Getting started Connections to external data systems
External data systems supported with built-in connectors
Working with Active Directory Working with an AD LDS (ADAM) instance Working with Skype for Business Server Working with Oracle Database Working with Oracle Database user accounts Working with Exchange Server Working with Active Roles Working with One Identity Manager Working with a delimited text file Working with Microsoft SQL Server Working with Micro Focus NetIQ Directory Working with Salesforce Working with ServiceNow Working with Oracle Unified Directory Working with an LDAP directory service Working with an OpenLDAP directory service Working with IBM DB2 Working with IBM AS/400 Working with IBM RACF Working with MySQL database Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft 365 Working with Microsoft Azure Active Directory Configuring data synchronization with the SCIM Connector Configuring data synchronization with the Generic SCIM Connector
Using connectors installed remotely Creating a connection Renaming a connection Deleting a connection Modifying synchronization scope for a connection Using connection handlers Specifying password synchronization settings for a connection
Synchronizing identity data Mapping objects Automated password synchronization Synchronization history Scenarios of use Developing PowerShell scripts for attribute synchronization rules Using PowerShell script to transform passwords

Mapping objects

Object mapping allows you to establish one-to-one relationships between objects in two connected data systems. By using object mapping, you can determine what objects will participate in data synchronization operations you run between these two data systems.

Synchronization Service maps objects automatically when running the creating steps of a sync workflow. In this case, a one-to-one relationship is automatically established between source objects and their counterparts created in the target connected system during the creation operation. In some cases, however, you may have to manually map objects. For example, you should configure object mapping before running a sync workflow that includes updating or deprovisioning steps. By doing so, you provide Synchronization Service with the information on which objects need to be updated or deprovisioned in the target data system.

To map objects, you can use mapping pairs and mapping rules. A mapping pair allows you to establish a relationship between a certain object type in one connected system and its counterpart in the other connected system. A mapping rule allows you to define the scope of conditions where the objects belonging to the object types specified in a particular mapping pair will be mapped. You can create multiple mapping rules for a mapping pair, with each mapping rule defining a specific mapping condition. You have to run your mapping rules for them to take effect. After you run a mapping rule, Synchronization Service reads data in the connected data systems for which the rule is configured, and then maps the objects that meet the conditions specified in the mapping rule.

The following example shows how a mapping rule works:

Figure 12: Object mapping

In this example, one-to-one relationship is established between the user object John Malcolm in Connected System 1 and the user object John Doe in Connected System 2: the first names of these user objects match, and thus the condition specified in the mapping rule is met. Now, if you configure a sync workflow for these systems and populate it with synchronization steps, identity information will be synchronized between these two user objects, since they are mapped. The direction of synchronization depends on which of these two connected data systems acts as the synchronization source and which is the target.

How to map objects

You can map objects in two data systems to which Synchronization Service is connected.

Creating mapping pairs

In this step, you create mapping pairs that specify the types of objects you want to map in two connected systems. You can create as many mapping pairs as required.

To create a mapping pair

  1. In the Synchronization Service Console, open Mapping.

  2. Click the name of the connection for which you want to map objects.

  3. Click Add mapping pair.

  4. On the Specify source page, next to Connected system object type, click Select, and then select the type of object you want to map.

  5. Click Next.

  6. On the Specify target page:

    1. Next to Target connected system, click Specify, and then specify the other connected system where you want to map objects.

    2. Next to Connected system object type, click Select, and then select the type of object you want to map.

  7. To create the mapping pair, click Finish.

    Repeat the above steps to create mapping pairs for as many object types as required.

Creating mapping rules

Once you have created a mapping pair, you can configure mapping rules for that pair. Mapping rules define the conditions where the objects that belong to the object types specified in the mapping pair will be mapped. Synchronization Service maps objects only if all mapping rules specified for a mapping pair are met.

To add a new mapping rule

  1. In the Synchronization Service Console, open Mapping.

  2. Click the name of the connection for which you want to create a mapping rule.

  3. Click the mapping pair for which you want to create a mapping rule.

  4. Click Add mapping rule.

  5. Use the Define Mapping Rule dialog to define the condition where the objects in the connected systems are to be mapped. To do so, click the down arrow on the button next to each of the two provided options and select one of the following:

    • Attribute: Allows you to select an attribute in the connected system.

    • Rule: Allows you to set up a list of rules to generate a value for the connected system. For more information, see Using value generation rules.

    • PowerShell Script: Allows you to type a Windows PowerShell script that generates a value for the connected system.

  6. When you are finished, click OK to create the mapping rule.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating