Step 5: Provide certificate’s thumbprint to Capture Agent
This step assumes that:
- The same Group Policy object is linked to each OU holding the domain controllers on which the Capture Agent is installed. For more information on how to create and link a Group policy object, see the documentation for your version of Windows.
- The SyncServiceCaptureAgent.adm administrative template file is linked to that Group Policy object.
For instructions on how to add an administrative template file to a Group Policy object, see Step 2: Add administrative template to Group Policy object
To provide the thumbprint to Capture Agent
On any computer joined to the domain where Capture Agent is installed, open Group Policy Object Editor, and connect to the Group Policy object to which you added the Administrative Template in Step 2: Add administrative template to Group Policy object.
- In the Group Policy Object Editor console, expand the Group Policy object, and then expand the Computer Configuration node.
- Expand the Administrative Templates\Active Roles node to select Sync Service Capture Agent Settings.
- In the details pane, double-click Certificate to encrypt Capture Agent traffic.
- Select the Enabled option, and then paste the certificate’s thumbprint (the one you copied in Step 4: Copy certificate’s thumbprint) in the Thumbprint text box. When finished, click OK.
- For the changes to take effect, refresh the Group Policy settings by running the following command at a command prompt: gpupdate /force
Step 6: Provide certificate’s thumbprint to Synchronization Service
Step 6: Provide certificate’s thumbprint to Synchronization Service
Perform the next steps on each computer running the Synchronization Service that participates in the password sync operations.
To provide the thumbprint to Synchronization Service
- On the computer running the Synchronization Service, start Group Policy Object Editor, and then connect to the Local Computer Policy Group Policy object.
- In the Group Policy Object Editor console, expand the Local Computer Policy node, expand the Computer Configuration node, and select Administrative Templates.
- On the Action menu, point to All Tasks, and click Add/Remove Templates.
- In the Add/Remove Templates dialog box, click Add, and then use the Policy Templates dialog box to open the SyncService.adm file that holds the Administrative Template.
- By default, the SyncService.adm file is stored in <Active Roles installation folder>\SyncServiceCaptureAgent\Administrative Templates.
- Under Computer Configuration\Administrative Templates\Active Roles, select Sync Service Settings.
- In the details pane, double-click Certificate to encrypt Capture Agent traffic.
- Select the Enabled option, and then paste the certificate’s thumbprint (the one you copied in Step 4: Copy certificate’s thumbprint) in the Thumbprint text box. When finished, click OK.
- For the changes to take effect, refresh the Group Policy settings by running the following command at a command prompt: gpupdate /force
Using PowerShell scripts with password synchronization
Optionally, you can configure the Synchronization Service to run your custom PowerShell script before, after, or instead of the password synchronization operation. To do so, create a connection handler. For instructions, see Using connection handlers.
Example of a PowerShell script run after password synchronization
#---- Specify the SMTP Server name in your organization ----
$SmtpServer = "smtpServerName"
$smtp = new-object system.net.mail.smtpClient($SmtpServer)
$mail = new-object System.Net.Mail.MailMessage
# ---- Set the sender mail ----
$mail.From = "yourmail@mydomain.com"
# ---- Set the destination mail ----
$mail.To.Add("Administrator@mydomain.com")
# --- Specify the message subject ----
$mail.Subject = "Password was changed"
# ---- Set the message text ----
$body = "The passwords were synchronized for the following object pair: "
$body = $body + $srcObj.Name + "->" + $dstObj.Name
$mail.Body = $body
# ---- Send mail ----
$smtp.Send($mail)
Description: After the password synchronization is complete, this script sends a notification email message informing the administrator that the specified object password has been modified in the target connected system. The message provides the names of the source Active Directory object and its counterpart in the target connected system.