立即与支持人员聊天
与支持团队交流

Active Roles 8.1.1 - Synchronization Service Administration Guide

Synchronization Service overview Deploying Synchronization Service 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 Objects and operations supported by the SCIM Connector Example of using the Generic SCIM Connector for data synchronization
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

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.

Change scope for mapping rules

Each mapping rule applies to a scope of objects. By default, this scope includes all objects that belong to the object types specified in the mapping rule. If necessary, you can narrow the scope specified for a particular mapping rule or you can revert to the default scope.

To change the scope of a mapping rule

  1. In the Synchronization Service Console, open Mapping.
  2. Click the name of the appropriate connection.

  3. Click the appropriate mapping pair entry.

  4. Locate the mapping rule whose scope you want to change. Use the following elements provided for each mapping rule entry:

    • Mapping scope for system 1: Shows the mapping rule scope applicable to the data system shown on the left part of the mapping pair entry.

    • Mapping scope for system 2: Shows the mapping rule scope applicable to the data system shown on the right part of the mapping pair entry.

    These elements can take one of the following values:

    • Default: Indicates that the mapping rule applies to all objects of the specified type.

    • Custom: Indicates that the mapping rule scope is narrowed down and only applies to some objects of the specified type.

  5. Change the mapping rule scope as necessary:

    1. Click the value displayed next to Mapping scope for system 1 or Mapping scope for system 2, and then specify the scope you want to use.

    2. When you are finished, click OK.

Running map operation

Once you have created mapping rules for a mapping pair, you have to run the map operation in order to apply these rules and map objects that belong to the mapping pair.

There are two methods to run the map operation:

  • Running the map operation once, manually.

  • Creating a recurring schedule to automatically run the map operation on a regular basis.

    TIP: This method is recommended when you want to use Synchronization Service to synchronize passwords from an Active Directory domain to other connected systems.

Running the map operation once, manually

This method allows you to run your mapping rules without creating a recurring schedule.

To run the map operation once, manually

  1. In the Synchronization Service Console, open Mapping.
  2. Click the name of the connection for which you want to run the map operation.

  3. Click the mapping pair for which you want to run the map operation.

  4. Click Map now.

  5. In the dialog that opens, click one of the following:

    • Full Map: With this option, Synchronization Service retrieves the data required to map objects from the connected data systems.

    • Quick Map: With this option, Synchronization Service first tries to map objects by using the data that is available in the local cache. If the local cache is missing or cannot be used to map objects, then Synchronization Service retrieves the required data from the connected data systems.

    Wait for the map operation to complete.

    After the map operation is completed, the Synchronization Service Console displays a report that provides information about the objects that participated in the map operation. At this stage, the application does not map the objects. To map the objects, you have to commit the map operation result.

    You can click the number that is provided next to an object category name in the report to view the details of objects that belong to that category.

  6. Review the report about the objects that participated in the map operation, then click Commit to map the objects.

Creating a recurring schedule to automatically run the map operation on a regular basis

Running mapping rules on a recurring schedule allows you to properly map newly-created Active Directory user objects to their counterparts in the connected systems where you automatically synchronize passwords with the Active Directory domain. If you do not run mapping rules on a regular basis, some passwords may become out of sync due to the changes that inevitably occur to your environment. For example, new user objects are created, some user objects are deleted, but Synchronization Service cannot detect these changes and synchronize passwords for the newly-created users before you apply the mapping rules. In this scenario, the best way to ensure Synchronization Service synchronizes all passwords is creating a recurring schedule for applying your mapping rules on a regular basis.

To create a recurring schedule to automatically run the map operation on a regular basis

  1. In the Synchronization Service Console, open Mapping.
  2. Click the name of the connection for which you want to create a recurring mapping schedule.

  3. Click the mapping pair for which you want to run the map operation on a recurring schedule.

  4. Click Schedule mapping.

  5. In the dialog that opens, select the Schedule the task to run check box, and then specify a schedule for the map operation.

    One Identity recommends that you schedule the map operation to run once in every 6 hours.

  6. If several Synchronization Service instances are installed in your environment, under Run the task on, select the computer that hosts the instance you want to use for running the map operation.

  7. Click OK to activate the schedule.

    The results of a scheduled map operation always apply automatically. As a result, you do not have to commit the changes after the scheduled operation is completed.

    When performing a scheduled map operation, Synchronization Service always retrieves the required data from the connected data systems and never uses the data available in the local cache.

相关文档

The document was helpful.

选择评级

I easily found the information I needed.

选择评级