Active Roles 7.3.3 - Synchronization Service Administration Guide

Synchronization Service Overview Deploying Synchronization Service Getting started Connections to external data systems
External data systems supported out of the box
Working with Active Directory Working with an AD LDS (ADAM) instance Working with Skype for Business Server Working with Exchange Server Working with Active Roles Working with One Identity Manager Working with a delimited text file Working with Microsoft SQL Server Sample queries to modify SQL Server data Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft Office 365 Working with Microsoft Azure Active Directory
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 Appendix A: Developing PowerShell scripts for attribute synchronization rules Appendix B: Using a PowerShell script to transform passwords

About mapping objects

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.

Synchronization Service maps objects automatically when running the creating steps of a sync 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 creation operation. In some cases, however, you may need 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. 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, 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 9: 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.

The next sections cover the following:

Steps to map objects

Steps to map objects

You can map objects in two data systems to which Synchronization Service is connected. To map objects in two connected data systems, complete the following steps:

Step 1: Create mapping pairs

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 Synchronization Service 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

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