Chat now with support
Chat with Support

Quick Connect Sync Engine 6.1 - Administrator Guide

One Identity Quick Connect Overview Deploying One Identity Quick Connect Sync Engine Getting started Connections to external data systems Synchronizing identity data Mapping objects Automated password synchronization Synchronization history Scenarios of use Appendices

About 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.

Quick Connect maps objects automatically when running the provisioning steps of a synchronization workflow. In this case, one-to-one relationship is automatically established between source objects and their counterparts created in the target connected system during the provision operation. In some cases, however, you may need to manually map objects. For example, you should configure object mapping before running a synchronization workflow that includes updating or deprovisioning steps. By doing so, you provide One Identity Quick Connect Sync Engine 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. For a mapping pair you can create multiple mapping rules, each defining a specific mapping condition. In order your mapping rules take effect, you need to run them. After you run a mapping rule, One Identity Quick Connect Sync Engine 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:

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 synchronization 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.

The next sections cover the following:

Steps to map objects

You can map objects in two data systems to which One Identity Quick Connect Sync Engine is connected. To map objects in two connected data systems, complete the following steps:

Step 1: Create 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 necessary.

To create a mapping pair

  1. In the Quick Connect Administration Console, open the Mapping tab.
  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, do the following:
    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. Click Finish to create the mapping pair.

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

Step 2: Create 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. One Identity Quick Connect Sync Engine maps objects only if all mapping rules specified for a mapping pair are met.

To add a new mapping rule

  1. In the Quick Connect Administration Console, open the Mapping tab.
  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 box 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 details, 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