Identity Manager 8.2.1 - Target System Synchronization Reference Guide

Sometimes is not necessary to access the connected system Closed with the Synchronization Editor Closed . In this case, the Synchronization Editor can be run in offline mode. For example, in offline mode connection configurations can be viewed and edited without One Identity Manager attempting to connect to the respective system.

To start the Synchronization Editor in offline mode

Start a command line program and go to the One Identity Manager installation directory.
Run the Synchronization Editor with the -o option.

SynchronizationEditor.exe -o

Offline mode is enabled by default. You can disable offline mode with the Offline mode button in the toolbar.

Related topics

Starting the Synchronization Editor

Working with an encrypted database

When you set up a synchronization project Closed in an encrypted One Identity Manager database, sensitive data is encrypted. This affects passwords for connection data as well as variables that are labeled as secret. The Synchronization Editor Closed requires all connection data in decrypted form in order to access connected systems Closed . You can nevertheless open the synchronization project and edit it partially.

If the Synchronization Editor now accesses the connection system, it cannot establish a system connection because certain connection parameters are encrypted. The values can be decrypted through an appropriately configured remote connection. Set up a remote connection server to do this. For more information, see Establish remote connection. Note here the relevant restrictions for setting up a remote connection server.

To enable the system connection despite encrypted connection data

Edit the system connection.

For more information, see How to edit system connection properties.

An extra dialog box is displayed.
Set the first option and click OK.
1. Enter the remote connection properties.
  
  For more information, see Remote connection properties.
2. Click Connect.
  
  This sets up the remote connection. The connection remains in place for as long as the synchronization project is open in the Synchronization Editor.

NOTE: If a remote connection is not possible, you have the option, at this point, to enter values for establishing the system connection.

Set the second option for this and enter the missing values. Click OK.

To decrypt encrypted values by default when you open a synchronization project

In the Designer, set the "DPR | UI | EncryptedValueHandling" configuration parameter and select the value "ByUser" on the Options tab.
The user can decide whether encrypted values should be ignored or not.

Table 18: Decryption dialog
Property	Description
Encrypted value	Value required by the connector to establish a system connection.
Ignore this value	Specifies whether to ignore the value. The synchronization project can be selectively edited. However, all actions which required accessing the connected system, cannot be run.
Show values	Specifies whether the values entered are shown. If this option is not set, input is masked.
Remember the values and save locally	Specifies whether the data entered is saved locally. The next time the synchronization project is opened, the stored values are applied and can be confirmed or altered. IMPORTANT: If an encrypted value has been changed in the One Identity Manager database, the changed value must also be changed on the workstation as soon as the synchronization project is next opened. Otherwise, the value is overwritten by the locally stored data when the synchronization project is saved. Modifications (of passwords, for example) go missing this way! To avoid overwriting Update the pre-set values and enable the Remember the values and save locally option. To delete locally saved data Select the Database > Settings... menu item. Select the Security tab. Select a value and click Delete.
Ignore all	Ignores encrypted values and open the synchronization project.

Changing a synchronization user's password

One Identity Manager provides a system user with all the permissions necessary to set up target system synchronization Closed through an application server and to run it. When you set up the One Identity Manager database, you entered a password for the Synchronization system user. You can change this password in the Synchronization Editor Closed . The password must then be changed in all synchronization projects Closed that connect to the database through an application server. One Identity Manager can try to update these passwords automatically. If this is not possible, modify the synchronization projects manually.

IMPORTANT: The password may not be changed while synchronization is starting up or running. Only change the password outside working hours!

Only passwords that are managed in One Identity Manager can be changed. There is no menu item shown for externally managed passwords. For detailed information about managing system user passwords, see the One Identity Manager Authorization and Authentication Guide.

To change the system user's Password

Select the Database > Change synchronization user password menu item.
Enter the required data:
Click OK.

Table 19: Password data
Property	Description
Old password	Password valid until now.
New password and password confirmation	New password for the system user to log on to the database.
Show passwords	Passwords are not masked.
Try to update existing synchronization projects	One Identity Manager checks all the synchronization projects and tries to update the password. The password is only changed in synchronization projects that are connected with the database through an application server.

To manually update the database connection password

Open the synchronization project which needs to have its password updated.
Select the Configuration > One Identity Manager connection category.
Confirm the prompt with OK.
Do not establish a remote connection.
Click Edit connection.
Select the Connection parameter page in the system connection wizard.
Enter the new password in Synchronization user's password.
Click Test.
If the connection is successfully established, click Next.
Close the system connection wizard.
Save the changes.

Table 20: Basic synchronization terminology
Term	Described in
Dependency resolution	How does dependency resolution work?
Outstanding objects	Deleting objects in One Identity Manager
Synchronization of single objects	Synchronization and provisioning
Filter	What are filters?
Mapping direction	Direction of synchronization and mapping Mapping against the direction of synchronization
Primary and secondary systems	Synchronizing user data with different systems
Provisioning	Synchronization and provisioning
Revision filter	How does revision filtering work?
Schema	How are schemas mapped
Scope	What is a scope?
Direction of synchronization	Direction of synchronization and mapping
Rogue modification	Detecting rogue modifications

Table 20: Basic synchronization terminology

Term

Described in

Dependency resolution

How does dependency resolution work?

Outstanding objects

Deleting objects in One Identity Manager

Synchronization of single objects Closed

Synchronization and provisioning

Filter Closed

What are filters?

Mapping direction Closed