Chat now with support
Chat with Support

Active Roles 8.0.1 LTS - Synchronization Service Administration Guide

Synchronization Service Overview Deploying Synchronization Service 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 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 IBM DB2 Working with IBM AS/400 Working with an OpenLDAP directory service Working with IBM RACF connector Working with MySQL database Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft 365
Creating a Microsoft 365 connection Modifying a Microsoft 365 connection Microsoft 365 data supported for data synchronization
ClientPolicy object attributes supported for Microsoft 365 data synchronization ConferencingPolicy object attributes supported for Microsoft 365 data synchronization Contact object attributes supported for Microsoft 365 data synchronization DistributionGroup object attributes supported for Microsoft 365 data synchronization Domain object attributes supported for Microsoft 365 data synchronization DynamicDistributionGroup object attributes supported for Microsoft 365 data synchronization ExternalAccessPolicy object attributes supported for Microsoft 365 data synchronization HostedVoicemailPolicy object attributes supported for Microsoft 365 data synchronization LicensePlanService object attributes supported for Microsoft 365 data synchronization Mailbox object attributes supported for Microsoft 365 data synchronization MailUser object attributes supported for Microsoft 365 data synchronization PresencePolicy object attributes supported for Microsoft 365 data synchronization SecurityGroup object attributes supported for Microsoft 365 data synchronization SPOSite object attributes supported for Microsoft 365 data synchronization SPOSiteGroup object attributes supported for Microsoft 365 data synchronization SPOWebTemplate object attributes supported for Microsoft 365 data synchronization SPOTenant object attributes supported for Microsoft 365 data synchronization User object attributes supported for Microsoft 365 data synchronization VoicePolicy object attributes supported for Microsoft 365 data synchronization Microsoft 365 Group attributes supported for Microsoft 365 data synchronization Changing the display names of synchronized Microsoft 365 licenses and services
Objects and attributes specific to Microsoft 365 services How the Microsoft 365 Connector works with data
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
About scenarios Scenario 1: Create users from a .csv file to an Active Directory domain Scenario 2: Use a .csv file to update user accounts in an Active Directory domain Scenario 3: Synchronizing data between One Identity Manager Custom Target Systems and an Active Directory domain Scenario 4: Deprovisioning between One Identity Manager Custom Target Systems and an Active Directory domain Scenario 5: Provisioning of Groups between One Identity Manager Custom Target Systems and an Active Directory domain Scenario 6: Enabling Delta Sync mode between One Identity Manager Custom Target Systems and an Active Directory domain Example of using the Generic SCIM Connector for data synchronization
Appendix A: Developing PowerShell scripts for attribute synchronization rules Appendix B: Using a PowerShell script to transform passwords

Modifying a One Identity Manager connection

To modify connection settings

  1. In the Synchronization Service Administration Console, open the Connections tab.
  2. Click Connection settings below the existing One Identity Manager connection you want to modify.
  3. Expand Specify connection settings and use the following options to modify the settings as necessary:
    • Application Server URL. View or change the address of the One Identity Manager application server for this connection.
    • Authentication module. Identifies the One Identity Manager authentication module that is used to verify the connection’s user ID and password.
    • User name. View or change the user ID for this connection.
    • Password. Specify the password of the user ID for this connection.
    • Test Connection. Click to verify the specified connection settings.
  4. Click Next.

    The One Identity Manager modules, target systems, and containers are displayed.

  1. Select the required One Identity Manager modules.

    NOTE: The One Identity Manager target systems and One Identity Manager containers are applicable only for the Target System Base module (UNS..B tables).

  1. Click Finish to create a connection to One Identity Manager.

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

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

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.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating