Chat now with support
Chat with Support

Active Roles 7.2.1 - Synchronization Service Administrator 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 Quest One Identity Manager 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

Modifying an existing Active Directory connection

To modify connection settings

  1. In the Synchronization Service Administration Console, open the Connections tab.
  2. Click Connection settings below the existing Active Directory connection you want to modify.
  3. On the Connection Settings tab, click the Specify connection settings item to expand it, and then use the following options:
    • Any available domain controller in the specified domain. Allows you to connect to any 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, Synchronization Service automatically selects the appropriate domain controllers in the forest to read and write data according to the synchronization scope configured for the connection.
      • Secure Sockets Layer usage. Use this list to select one of the following:
        • None. Allows you to connect without using Secure Sockets Layer (SSL).
        • Use. Allows you to connect through SSL.
        • Preferred. Allows you to attempt the connection through SSL first. If this connection attempt fails, the Synchronization Service tries to connect without using SSL.
    • Access Active Directory using. Use this option to select one of the following:
    • Synchronization Service account. Allows you to access Active Directory in the security context of the account under which the Synchronization Service is running.
    • Windows account. Allows you to access Active Directory in the security context of the account whose user name and password you specify below this option.
    • Test Connection. Click this button to verify the specified connection settings.
  4. 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 the Add Object Type button 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.
  5. When you are finished, click Save.

Communication ports required to synchronize data between two AD domains

Connections to external data systems > External data systems supported out of the box > Working with Active Directory > Communication ports required to synchronize data between two AD domains

When Synchronizing data between two Active Directory domains, Synchronization Service uses the following ports to access domain controllers in the domains:

 

Table 8:  Required communication ports

Port

Protocol

Type of traffic

Direction of traffic

53

TCP/UDP

DNS

Inbound

88

TCP/UDP

Kerberos

Outbound

389

TCP/UDP

LDAP

Outbound

636

TCP

LDAP over SSL (LDAPS)

Outbound

Synchronizing user passwords between two AD domains

You can automatically synchronize user passwords from one Active Directory domain to the other by using Synchronization Service. The next procedure assumes that Synchronization Service is already connected to the source and target domains. For more information, see Creating an Active Directory connection.

To synchronize user passwords between two AD domains

  1. Install Capture Agent on all domain controllers in the source and target Active Directory domains.
  2. Use the pwdHash attribute to perform an initial synchronization of user passwords between the source and target domains:
    1. Create a new or choose an existing creating or updating synchronization step for the source and target domains.
    2. If you use an updating synchronization step, ensure that user objects in the source domain are properly mapped to their counterparts in the target domain. For more information on mapping objects, see Mapping objects.
    3. In the creating or updating synchronization step, configure a rule to synchronize the pwdHash attribute value from the user objects in the source domain to their counterparts in the target domain.
    4. Run the creating or updating synchronization step to perform an initial synchronization of user passwords from the source to the target domain.

    Step 2 allows you to synchronize user passwords only once. If you want to synchronize all subsequent password changes on a permanent basis, complete step 3.

  1. Create a recurring run schedule for the synchronization step you configured in step 1 of this procedure. For instructions, see Running a sync workflow on a recurring schedule.
    • To synchronize all subsequent password changes from the source to the target domain, do one of the following:
    • Configure a password sync rule to automate the password synchronization between the two Active Directory domains. For instructions, see Automated password synchronization.

Synchronizing SID history of users or groups

You can use Synchronization Service to synchronize SID history between user or group objects in two Active Directory domains. For example, you can synchronize SID history when migrating users from one Active Directory domain to the other.

Before you start synchronizing SID history, consider the following:

  • To read SID data in the source Active Directory domain, you can use the sIDHistory or objectSid attribute.
  • To write SID data to the target Active Directory domain, always use the sIDHistory attribute.

To synchronize SID history of users or groups

  1. Install Capture Agent on all domain controllers in the source and target Active Directory domains you want to participate in the SID history synchronization.

    For instructions on how to install Capture Agent, see Managing Capture Agent.

  1. Use the Specified domain controller option to connect Synchronization Service to the source and target domains.

    For instructions on how to connect Synchronization Service to an Active Directory domain, see Creating an Active Directory connection.

  1. Create a new or choose an existing creating or updating synchronization step for the source and target domains.

    If you use an updating synchronization step, ensure that user or group objects in the source domain are properly mapped to their counterparts in the target domain. For more information on mapping objects, see Mapping objects.

  1. Configure the synchronization step to do the following:
    • Read SID data in the source Active Directory domain. For this purpose, you can use the sIDHistory attribute or the objectSid attribute, or both.
    • Write SID data to the target Active Directory domain by using the sIDHistory attribute.

    To read attribute values in the source domain and write them to the target domain, you can configure attribute modification rules in your sync workflow step. For detailed instructions, see Modifying attribute values by using rules.

  1. Run the created step to synchronize SID history.
Related Documents