B.1 Driver Configuration

In iManager:

  1. Login to iManager, select Identity Manager Administration if not defaulted already.

  2. Select Identity Manager Overview, the Identity Manager Overview page appears

  3. Click Driver Sets tab, the configured drivers appear.

    NOTE:If the driver set is not listed on the Driver Sets tab, use the Search In field to search for and display the driver set.

  4. Click the driver name, the Driver Set Overview page appears.

  5. Click the driver actions button and select Edit properties to display the driver’s properties page.

    By default, the Driver Configuration page is displayed.

In Designer:

  1. Open a project in the Modeler.

  2. Right-click the driver icon or line, then select click Properties > Driver Configuration.

The Driver Configuration options are divided into the following sections:

B.1.1 Driver Module

The driver module changes the driver from running locally to running remotely or the reverse.

Java: Use this option to specify the name of the Java class that is instantiated for the shim component of the driver. This class can be located in the classes directory as a class file, or in the lib directory as a .jar file. If this option is selected, the driver is running locally.

For example, com.microfocus.nds.dirxml.driver.scim.SCIMDriverShim

Native: This option is used to specify name of the .dll which is developed in native language (such as C++) for the driver.

For example, addriver.dll

Connect to Remote Loader: Used when the driver is connecting remotely to the connected system. Designer includes two sub options:

  • Remote Loader Connection Parameters: Includes information of the Remote Loader environment details such as, Host Name, Connection Port, etc.

  • Remote Loader Password: The password for the Remote Loader.

  • Driver Object Password: Specifies a password for the Driver object. If you are using the Remote Loader, you must enter a password on this page. The Remote Loader uses this password to authenticate itself to the remote driver shim.

B.1.2 Authentication

This section describes the parameters required for server authentication for Identity Manager Engine and the Remote Loader.

Field

Description

Authentication information for server

Displays or specifies the IP address or server name that the driver is associated with.

Application authentication

  • Authentication ID: Specify a user application ID. This ID is used to pass Identity Vault subscription information to the application.

  • Connection Information: Specify the IP address or name of the server the application shim should communicate with.

  • Set Password: Option to set the application authentication password.

Remote Loader authentication (Optional): Used only if the driver is connecting to the application through the Remote Loader.

  • Host name: Enter the Host Name or IP Address where the Remote Loader Service has been installed and is running for this driver.

  • Port: Enter the Port Number where the Remote Loader Service has been installed and is running for this driver. The Default Port is 8090.

  • KMO: Enter the Key Name of the Key Material Object containing the keys and certificate used for SSL The KMO parameter is used only when an SSL connection exists between the Remote Loader and the Metadirectory engine.

  • Other parameters: Enter other parameters required, if any, in the connection string. These parameters MUST be in the key-value pair. Example, paraNamel =paraValue1 paraName2=paraValue2

  • Set Password: The Remote Loader password is used to control access to the Remote Loader instance. It must be the same password that is specified as the Remote Loader password on the Identity Manager Remote Loader.

B.1.3 Startup Option

The Startup Option section allows you to set the driver state when the Identity Manager server is started.

Auto start: The driver starts every time the Identity Manager server is started.

Manual: The driver does not start when the Identity Manager server is started. The driver must be started through Designer or iManager.

Disabled: The driver has a cache file that stores all of the events. When the driver is set to Disabled, this file is deleted and no new events are stored in the file until the driver state is changed to Manual or Auto Start.

B.1.4 Driver Parameters

The Driver Parameters section lets you configure the driver-specific parameters. When you change the driver parameters, you tune the driver behavior to align with your network environment.

The parameters are presented by category:

Driver Settings

Custom Java Extensions: Select Show if you have developed custom Java classes to extend the driver shim’s functionality. Otherwise, select Hide.

  • Document Handling: Select Implemented if you have developed a custom Java class to process data as XML documents. Otherwise, select None.

    • Class: Specify the class by using a complete package identifier. For example, com.novell.DocumentModifier.

    • Init Parameter: Specify the parameter to pass to the init() method of the specified class. The init method is responsible for parsing the information contained in this string. Leave this field blank if the configuration string is not required for the class.

Subscriber Settings

Authentication Method: The authentication types are configured based on the parameters that the connected application supports. For more information on the authentication types the driver supports refer to the specific driver guide on the Identity Manager Drivers Documentation Website.

Publisher Options

Once the driver is configured, You can edit the publisher options to specify Polling Interval, Polling Resources and Heartbeat Interval. Navigate to Driver Configuration > Publisher Options tab to edit or specify these options. For more information refer to the specific driver guide on the Identity Manager Drivers Documentation Website.

B.1.5 ECMAScript

Displays an ordered list of ECMAScript resource files. The files contain the extension functions for the driver that Identity Manager loads at the time of driver starts. You can add additional files, remove existing files, or change the order the files that are executed.

B.1.6 Global Configuration

Displays an ordered list of Global Configuration objects. The objects contain extension GCV definitions for the driver that Identity Manager loads at the time of driver starts. You can add or remove the Global Configuration objects, and you can change the order in which the objects are executed.