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

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:

 

Table 10: Prerequisites by scenario

Supported scenario

Prerequisites

Scenario 1: AD domain includes either 32- or 64-bit domain controllers

All the domain controllers must be held in a single organizational unit (for example, the built-in Domain Controllers OU).

At least one group policy object must be linked to the OU holding the domain controllers (for example, the built-in Default Domain Controllers Policy Group Policy object).

Scenario 2: AD domain includes both 32- and 64-bit domain controllers

The domain controllers must be held in two separate organizational units, each containing domain controllers of the same bitness.

At least one group policy object must be linked to each of the two organizational units.

The next steps apply to both these scenarios.

To install Capture Agent by using Group Policy

  1. Save the QuickConnectCaptureAgent_x86.msi and QuickConnectCaptureAgent_x64.msi files supplied in the Quick Connect installation package 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:

 

Table 11:

Steps by scenario

Scenario 1: AD domain includes either 32- or 64-bit domain controllers

Scenario 2: AD domain includes both 32- and 64-bit domain controllers
  1. Use Group Policy Editor to open the group policy object linked to the OU holding the domain controllers on which you want to install Capture Agent.
  2. In the Group Policy Object Editor console tree, do one of the following:
    1. In Windows Server 2012 or 2012 R2, expand the Computer Configuration node, and then select Software Settings.
    2. In a later version of Windows Server, expand the Computer Configuration node, then expand Policies, and select Software Settings.
  3. In the details pane, click Software Installation, on the Action menu point to New, and then click Package.
  4. Use the dialog box to open one of the following files:
    1. QuickConnectCaptureAgent_x86.msi if all your domain controllers are 32-bit.
    2. QuickConnectCaptureAgent_x64.msi if all your domain controllers are 64-bit.
  5. In the Deploy Software dialog box, select Assigned, and then click OK.
  1. Use Group Policy Object Editor to open the group policy object linked to the OU holding the 32-bit domain controllers.
  2. Do one of the following in the Group Policy Object Editor console tree:
    1. In Windows Server 2012 or 2012 R2, expand the Computer Configuration node, and then select Software Settings.
    2. In a later version of Windows Server, expand the Computer Configuration node, then expand Policies, and select Software Settings.
  3. In the details pane, click Software Installation, on the Action menu point to New, and then click Package.
  4. Use the dialog box to open the QuickConnectCaptureAgent_x86.msi file.
  5. In the Deploy Software dialog box, select Assigned, and then click OK.
  6. Repeat steps 1-5 for the group policy object linked to the OU holding the 64-bit domain controllers. Use the QuickConnectCaptureAgent_x64.msi file to install Capture Agent on these domain controllers.

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 or 2012 R2, 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 Quick Connect Capture Agent.
  3. Uninstall the agent:
    • In Windows Server 2012 or 2012 R2, 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

To create a password sync rule

  1. In the Quick Connect 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 ActiveRoles Server 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 Quick Connect 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 Quick Connect to retry the password synchronization operation until it succeeds.
      • This maximum number of times. Specify the maximum number of times you want Quick Connect 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 One Identity Quick Connect Sync Engine modifies passwords in the target connected system.
    1. When you are finished, click OK.
  6. Click Finish to create the password sync rule.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating