Chat now with support
Chat with Support

Active Roles 7.2 - 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

Connections tab

Allows you to manage connections between the Synchronization Service and the external data systems you want to use for data synchronization operations.

For instructions on creating connections to external data systems supported out of the box, see External data systems supported out of the box.

On the Connections tab, you can use the following elements (some of these elements become available only after you create at least one connection):

  • Add connection. Allows you to create a new connection to an external data system.
  • Filter by. Allows you to filter existing connections by the letters or text you type in the text box. The filter applies to the connection names.
  • Sort by. Allows you to sort existing connections by connection name, name of the connector used, or the frequency of usage in sync workflow steps.
  • <Connection Name>. Represents a connection to external data system. You can click a connection name to view or modify the corresponding connection settings.
  • Connection settings. Allows you to view or modify settings for the connection.
  • Synchronization scope. Allows you to view or modify synchronization scope for the connection.
  • Delete connection. Deletes the connection.

Mapping tab

Allows you to manage mapping pairs and mapping rules for existing connections. To view or modify mapping pairs or rules for a connection, click the name of that connection on the Mapping tab. For more information on mapping pairs and rules, see Mapping objects.

On the Mapping tab, you can use the following elements (some of these elements become available only after you create at least one connection to an external data system):

  • Filter by. Allows you to filter existing connections by the letters or text you type in the text box. The filter only applies to the connection names.
  • Sort by. Allows you to sort existing connections by connection name, name of the connector used, or the frequency of usage in the sync workflow steps.
  • <Connection Name>. Displays the name of a connection. You can click a connection name to view or modify the mapping settings for the corresponding connection.

When you click a connection name on this tab, you can manage mapping pairs for the connection by using the following elements (some of these elements become available after you create at least one mapping pair for the connection):

  • Add mapping pair. Allows you to specify the types of objects in two connected systems for which you want to create a mapping pair.
  • <ObjectType1> - <ObjectType2>. Represents a mapping pair and displays the object types that belong to the same mapping pair. You can click a mapping pair to view and change the scope of conditions where the object types belonging to that mapping pair will be mapped. To define these conditions, you can create mapping rules.
  • Schedule. Allows you to schedule a recurring map operation for the current pair of objects.
  • Map now. Allows you to manually run the map operation on the current pair of objects.
  • Delete. Deletes the mapping pair on which you click this link.

When you click a mapping pair, you can manage mapping rules for the mapping pair by using the following elements (some of these elements become available only after you create at least one mapping rule for the mapping pair):

  • Map now. Allows you to manually run the map operation on the mapping pair by using the conditions specified in the existing mapping rules.
  • Unmap. Allows you to unmap the objects that were earlier mapped according to the settings specified for the mapping pair.
  • Schedule mapping. Allows you to schedule a recurring map operation for the mapping pair.
  • Add mapping rule. Allows you to create a rule that will define a condition for mapping objects that belong to the mapping pair.
  • Delete rule. Deletes the mapping rule on which you click this link.
  • Move up. Moves the current mapping rule one position up in the list.
  • Move down. Moves the current mapping rule one position down in the list.

Mapping rules are applied in the order they are listed.

Password Sync tab

Allows you to manage password sync rules to automate password synchronization from a specified Active Directory domain to other connected data systems. For more information, see Automated password synchronization.

On the Password Sync tab, you can use the following elements (some of these elements become available only after you create at least one password sync rule):

  • Add password sync rule. Allows you to create a rule for synchronizing passwords from an Active Directory domain to another connected system.
  • Password sync settings. Allows you to specify how many times you want to retry the password synchronization operation in the event of a failure. Also allows you to type a Windows PowerShell script to generate passwords for the target connected system. For more information, see Appendix B: Using a PowerShell script to transform passwords.
  • Delete rule. Deletes the password sync rule on which you click this link.

Configuring diagnostic logging

In the Synchronization Service Administration Console, you can configure a number of settings to write the Synchronization Service diagnostic data to a separate log file or to the Windows Event Log.

To configure diagnostic logging

  1. In the upper right corner of the Synchronization Service Administration Console, select
    Settings | Diagnostic Logging.
  2. In the dialog box that opens, use the following options:

 

Table 4:  Diagnostic logging options

Option

Description

Windows Event Log level

Drag the slider to select one of the following options to write Synchronization Service data to the Windows Event Log:

  • Error, Warning, and Information. Records errors, warnings, and information events generated by Synchronization Service to the Windows Event Log.
  • Error and Warning. Records error and warning events generated by Synchronization Service to the Windows Event Log.
  • Error. Records error events generated by Synchronization Service to the Windows Event Log.
  • Off. Disables writing Synchronization Service data to the Windows Event Log.

Synchronization Service log level

Drag the slider to select one of the following logging levels for the Synchronization Service log:

  • All Possible Events. Writes detailed diagnostic data to the Synchronization Service log file.
  • Important Events. Writes only essential events to the Synchronization Service log file.
  • Off. Disables writing data to the Synchronization Service log file.
  1. When you are finished, click OK to apply your settings.
Related Documents