Chat now with support
Chat with Support

Active Roles 8.1.5 - Synchronization Service Administration Guide

Synchronization Service overview Deploying Synchronization Service Deploying Synchronization Service for use with AWS Managed Microsoft AD Getting started Connections to external data systems
External data systems supported with built-in connectors
Working with Active Directory Working with an AD LDS (ADAM) instance Working with Skype for Business Server Working with Oracle Database Working with Oracle Database user accounts Working with Exchange Server Working with Active Roles Working with One Identity Manager Working with a delimited text file Working with Microsoft SQL Server Working with Micro Focus NetIQ Directory Working with Salesforce Working with ServiceNow Working with Oracle Unified Directory Working with an LDAP directory service Working with an OpenLDAP directory service Working with IBM DB2 Working with IBM AS/400 Working with IBM RACF Working with MySQL database Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft 365 Working with Microsoft Azure Active Directory Configuring data synchronization with the SCIM Connector Configuring data synchronization with the Generic SCIM Connector
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 Developing PowerShell scripts for attribute synchronization rules Using PowerShell script to transform passwords

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 38: 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.

For 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.

For 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

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 39: Delimited Text File Connector – Supported features

Feature

Supported

Bidirectional synchronization

Specifies whether you can both read and write data in the connected data system.

No

Delta processing mode

Specifies whether the connection can process only the data that has changed in the connected data system since the last synchronization operation. This reduces the overall synchronization duration.

Yes

Password synchronization

Specifies whether you can synchronize user passwords from an Active Directory (AD) domain to the connected data system.

No

Creating a delimited text file connection

To create a new connection

  1. In the Synchronization Service Console, open the Connections tab.
  2. Click Add connection, 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.

    • To test the connection with the new parameters, click Test connection.

  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:

    • 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

To modify connection settings

  1. In the Synchronization Service 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.

    You can expand the following items:

  4. When you are finished, click Save.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating