Active Roles 7.3.3 - Synchronization Service Administration 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 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

One Identity Manager Connector configuration file

One Identity Manager Connector configuration file

One Identity Manager connector saves its configuration settings in the configuration file (.xml file) located in the Active Roles Synchronization Service installation folder. You can edit the XML elements in the file to configure the various parameters of the One Identity Manager Connector. The table below describes the XML elements you can edit.

 

Table 52: XML elements

XML element

Description

<ExcludeDeletedObjects>

Specifies how Active Roles will treat objects marked as deleted in Identity Manager. This element can take one of the following values:

  • TRUE. Specifies to ignore deleted objects during data synchronization operations.
  • FALSE. Specifies to process deleted objects during data synchronization operations.

Example:

<ExcludeDeletedObjects>
TRUE
</ExcludeDeletedObjects>

<PasswordAttributes>

Specifies the default Identity Manager attribute to be used for storing passwords for objects of a particular type. Specifying an attribute for storing passwords in the Active Roles GUI overrides the value set in this XML element.

Example:

<PasswordAttributes>
   <PasswordAttributeDefinitions>
      <PasswordAttributeDefinition objectType="Person"       attribute="CentralPassword" />
   </PasswordAttributeDefinitions>
</PasswordAttributes>

<ReadFullSync>

Specifies a value of the FullSync variable for Read operations performed in Identity Manager.

<CreateFullSync>

Specifies a value of the FullSync variable for Create operations performed in Identity Manager.

<ModifyFullSync>

Specifies a value of the FullSync variable for Modify operations performed in Identity Manager.

<DeleteFullSync>

Specifies a value of the FullSync variable for Delete operations performed in Identity Manager.

<ObjRefFullSync>

Specifies a value of the FullSync variable for Modify Object Reference operations performed in Identity Manager.

<SyncStatusFullSync>

Specifies a value of the FullSync variable for Sync Status operations performed in Identity Manager.

For more information about the FullSync variable and the values it can take, see the One Identity Manager documentation.

Working with a delimited text file

Working with a delimited text file

This section describes how to create or modify a connection to a delimited text file so that Synchronization Service could work with data in that file.

To create a connection to a delimited text file, you need to use Synchronization Service in conjunction with a special connector called Delimited Text File Connector. This connector is included in the Synchronization Service package.

The Delimited Text File Connector supports the following features:

 

Table 53: Supported features

Feature

 

Bidirectional synchronization

Allows you to read and write data in the connected data system.

No

By using this connector, you can only read data in the connected data system.

Delta processing mode

Allows you to process only the data that has changed in the connected data system since the last synchronization operation, thereby reducing the overall synchronization operation time.

Yes

Password synchronization

Allows you to synchronize user passwords from an Active Directory domain to the connected data system.

No

In this section:

Creating a delimited text file connection

Creating a delimited text file connection

To create a new connection

  1. In the Synchronization Service Administration Console, open the Connections tab.
  2. Click Add connection, and then use the following options:
    • Connection name. Type a descriptive name for the connection.
    • Use the specified connector. Select Delimited Text File Connector.
  3. Click Next.
  4. On the Specify connection settings page, use the following options:
    • Delimited text file. Click Browse to locate and select the delimited text file to which you want to connect.
    • Access delimited text file using. Select an access option:
      • Synchronization Service account. Access the delimited text file in the security context of the account under which the Synchronization Service is running.
      • Windows account. Access the delimited text file 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.
  5. Click Next.
  6. On the Specify delimited text file format page, use the following options to provide information about the delimited text file format:
    • Delimiter. Select the delimiter used in the file you specified.
    • Use first row for attribute names. Select this check box if the first line of the specified file contains names of attributes. Otherwise, leave this check box cleared.
    • Advanced. Click this button to specify advanced options to access the delimited text file, such as encoding, row delimiter, value delimiter, and text qualifier.
  7. Click Next.
  8. On the Specify attributes to identify objects page, use the following options to select the attributes with which you want to uniquely identify each object in the file:
    • Available attributes. Lists the attributes that are available in the external data system. Use this list to select the attributes whose values you want to use to generate a unique identifier for each object in the external data system. You can filter attributes by typing in the text box at the top of this list. To select multiple attributes, hold down CTRL and click to select attributes in the list.
    • UniqueID attributes. Lists the attributes whose values are currently used to generate a unique identifier for each object in the external data system.
    • Add->. Moves the selected attributes from the Available attributes list to the UniqueID attributes list.
    • <-Remove. Moves the selected attributes from the UniqueID attributes list to the Available attributes list.
    • Constructed UniqueID. Displays a combination of the attributes whose values will make up a unique identifier for each object in the external data system.
  9. Click Finish to create a connection to the delimited text file.

Modifying an existing delimited text file connection

Modifying an existing delimited text file connection

To modify connection settings

  1. In the Synchronization Service Administration Console, open the Connections tab.
  2. Click Connection settings below the existing delimited text file connection you want to modify.
  3. On the Connection Settings tab, click an appropriate item to expand it and use the options it provides.
  4. You can expand the following items:

    See the next subsections for the descriptions of these items.

  1. When you are finished, click Save.
Related Documents