Active Roles 7.4.1 - Synchronization Service Administration Guide

Using Group Policy to install Capture Agent

You can use this method to automatically deploy Capture Agent on each domain controller in the source Active Directory domain. This method is applicable in the following scenarios only:

To install Capture Agent by using Group Policy

1. Save the SyncServiceCaptureAgent_7.4.1_x86.msi and SyncServiceCaptureAgent_7.4.1_x64.msi files to a network share accessible from each domain controller in the source Active Directory domain.
2. Depending on your scenario, complete the steps in the table:

3. Run the following command at a command prompt to refresh the Group Policy settings: gpupdate /force

Uninstalling Capture Agent

To uninstall Capture Agent

1. On the computer where Capture Agent is installed, open the list of installed programs:
   • In Windows Server 2012, open Add or Remove Programs in Control Panel.
   • In a later version of Windows, open Programs and Features in Control Panel.
2. In the list of installed programs, select One Identity Active Roles 7.4 - Synchronization Service Capture Agent x64 or One Identity Active Roles 7.4 - Synchronization Service Capture Agent x86.
3. Uninstall the agent:
   • In Windows Server 2012, click Remove.
   • In a later version of Windows, click Uninstall.
4. Follow the on-screen instructions to uninstall Capture Agent.

Managing password sync rules

To synchronize passwords from an Active Directory domain to other connected systems, you need to create and configure a password synchronization rule for each target connected system where you want to synchronize passwords.

A password synchronization rule allows you to specify the following:

• The Active Directory domain you want to be the source for password synchronization operations.
• The source object type for password synchronization operations (typically, this is the user object type in Active Directory).
• The target connected system in which you want to synchronize passwords with the source Active Directory domain.
• The target object type for password synchronization operations.

Optionally, you can configure a password synchronization rule to modify attribute values of the target connected system objects whose passwords are being synchronized.

This section covers:

• Creating a password sync rule
• Deleting a password sync rule
• Modifying settings of a password sync rule

Creating a password sync rule

To create a password sync rule

1. In the Synchronization Service Administration Console, open the Password Sync tab.
2. Click Add password sync rule.
3. On the Specify source for password sync page, do the following:
   1. In the Source connected system option, specify the Active Directory domain you want to be the source for password synchronization operations. Alternatively, you can select the Active Roles instance that manages such an Active Directory domain.
   2. In the Connected system object type option, select the object type you want to be the source for password synchronization.
4. Click Next.
5. On the Specify target for password sync page, do the following:
   1. In the Target connected system option, specify the target connected system in which you want to synchronize passwords.
   2. In the Connected system object type option, select the object type you want to be the target for password synchronization.
   3. Optionally, you can click the Password Sync Settings button and then use the following tabs to configure more password sync settings:
      • Password Sync Retry Options. Use this tab to specify how many times you want Synchronization Service to retry the password synchronization operation in the event of a password synchronization failure. You can select one of the following options:
      • Unlimited number of times. Causes Synchronization Service to retry the password synchronization operation until it succeeds.
      • This maximum number of times. Specify the maximum number of times you want Synchronization Service to retry the password synchronization operation.
      • Password Transformation Script. Use this tab to type a PowerShell script that transforms source Active Directory user passwords into object passwords for the target connected system. Use this item if you want the object passwords in the source and target connected systems to be different. If you do not want to transform passwords, leave the text box blank.
      • Rules to Modify Object Attributes. Use this tab to specify rules for modifying attribute values on the target connected system objects. These rules will only apply to the objects on which Synchronization Service modifies passwords in the target connected system.
   4. When you are finished, click OK.
6. Click Finish to create the password sync rule.