You can run the driver as a native Java module or as an Identity Manager driver on any supported platform.
You create the ID Provider driver object by installing the driver packages and then modifying the configuration to suit your environment. After you create and configure the driver, you need to deploy it to the Identity Vault and start it.
NOTE:You should not create driver objects by using the new Identity Manager 4.0 and later configuration files through iManager. This method of creating driver objects is no longer supported. To create drivers, you now need to use the new package management features provided in Designer.
The driver packages contain the items required to create a driver, such as policies, entitlements, filters, and Schema Mapping policies. These packages are only available in Designer and can be updated often after they are initially installed. You must have the most current version of the packages in the Package Catalog before you can create a new driver object.
To verify you have the most recent version of the driver packages in the Package Catalog:
Open Designer.
In the toolbar, click
> .Click
to update the packagesor
Click
if the packages are up-to-date.In the Outline view, right-click the Package Catalog.
Click
.Select any ID Provider driver packages
or
Click
to import all of the packages displayed.By default, only the base packages are displayed. Deselect
to display all packages.Click
to import the selected packages, then click in the successfully imported packages message.After the current packages are imported, continue with Section 3.1.2, Installing the Driver Packages.
After you have imported the current driver packages into the Package Catalog, you can install the driver packages to create a new driver object.
In Designer, open your project.
In the Modeler, right-click the driver set where you want to create the driver, then click
> .Select
, then click .On the ID Provider page, specify a name for the driver, then click
.On the ID Provider page, fill in the following fields:
LDAP server: Specify the IP address or DNS name of the LDAP server that contains the ID policies.
Policy Container DN: Specify the LDAP DN of the policy container.
Click
.On the ID Provider page, fill in the following fields:
Authentication ID: Specify the LDAP DN of a user with read/write access to the ID Policy container and its child objects.
Authentication Password: Specify the password of the user named in the
field.Click
.Fill in the following fields for Remote Loader information:
Connect To Remote Loader: Select Identity Manager 4.0.1 Remote Loader Guide.
or to determine if the driver will use the Remote Loader. For more information, see theIf you select Step 10. If you select , use the following information to complete the configuration of the Remote Loader.
, skip toHost Name: Specify the IP address or DNS name of the server where the Remote Loader is installed and running.
Port: Specify the port number for this driver. Each driver connects to the Remote Loader on a separate port. The default value is 8090.
Remote Loader Password: Specify a password to control access to the Remote Loader. It must be the same password that is specified as the Remote Loader password on the Remote Loader.
Driver Password: Specify a password for the driver to authenticate to the Metadirectory server. It must be the same password that is specified as the Driver Object Password on the Remote Loader.
Review the summary of tasks that will be completed to create the driver, then click
.After the driver packages are installed, if you want to change the configuration of the Role-Based Entitlement driver, continue to Section 3.1.3, Configuring the Driver Settings.
or
If you do not want to change the configuration of the driver, continue to Section 3.1.4, Deploying the Driver Object.
After you import the driver configuration file, the ID Provider driver will run. However, there are many configuration settings that you can use to customize and optimize the driver. The settings are divided into categories such as Driver Configuration, Engine Control Values, and Global Configuration Values (GCVs). The settings are described in Section A.0, Driver Properties.
If you do not have the Driver Properties page displayed in Designer:
Open your project.
In the Modeler, right-click the driver icon or the driver line, then select
.Make the changes you want, then continue to Section 3.1.5, Starting the Driver.
If you want to make additional changes to the driver, the following sections contain information about the driver parameters.
The ID policy repository parameters contain information about the location and how to access any ID policies.
Parameter |
Default Value |
Description |
---|---|---|
LDAP Server |
127.0.0.1 |
The IP address or DNS name of the LDAP server holding the ID policies |
LDAP Port |
636 |
The TCP port that the LDAP server listens on. The value is usually 389 for non-SSL connections and 636 for SSL connections. |
Use SSL |
True |
Specify whether or not you want to use SSL. |
Always trust |
True |
Specify whether or not you want to trust all servers. If this option is set to True, the ID provider trusts all LDAP servers even if the server certificate is untrusted. |
Policy Container DN |
LDAP DN for the policy container under the driver object. For example cn=id-policies,cd=id-provider,cn=driverset1,dc=idm,dc=services,dc=system. |
Specify or browse to the DN of the policy container in your tree. The policy container can only be created under the ID Provider driver. |
The client options are for the ID Provider clients. For more information, see Section 5.0, Configuring ID Clients.
Parameter |
Default Value |
Description |
---|---|---|
Client name |
ID-Provider Driver |
This is the name the driver uses when it acts as an ID client and requests and ID from the provider. This is useful for tracing and if access control is enabled on any of the ID policies. If access control is enabled, a list of ID client names can be specified that are allowed to obtain an ID from the policy. If the client name associated with the request is not in that list, the provider does not issue an ID. |
ID Generation Map |
workforceID=wfid |
Provide a comma-separated list of attribute=policy pairs. For example, workforceID=wfid,uniqueID=uid. This example configures the driver to request IDs from the wfid policy and stores them in the workforceID attribute whenever a new object is created or whenever someone tries to change this attribute. Similarly, IDs from the UID policy are used from the uid attribute. The driver only issues IDs for any attribute if that attribute and the object class holding the attribute are in both the Subscriber, Publisher, Filter, and are set to synchronize. Attribute names must be in the Identity Namespace (not LDAP) and must be case-exact. |
These options allow you to set up clients other than the ID Provider driver by using Java Remote Method Invocation (RMI). It also allows you to set ID Provider trace level.
Parameter |
Default Value |
Description |
---|---|---|
Start RMI |
True |
Controls whether the ID provider starts an RMI service or not. You only need a running RMI service if you request IDs from other clients than the driver (for example, DirXMLScript policies.) If all IDs are managed through this driver’s filter and ID Generation Map settings, then no RMI service is needed. |
RMI server |
172.17.2.117 |
Specify the IP address the RMI server binds to. Leave this field empty if you want the server to bind to all IP addresses. |
RMI port |
1199 |
Specify the TCP port the RMI service listens on. The defined standard port for RMI is 1099. If that port is already in use (you see errors in the trace when you start the driver), use a different port higher than 1023. This configuration assumes a port of 1199 to avoid common port conflicts. |
RMI Service port |
True |
The TCP port for the RMI ID Provider service. The server uses an ephemeral port if the value of this parameter is zero. |
RMI ID Provider Service IP |
True |
The IP address the client should use to connect to the RMI ID Provider server. In a non NAT environment, this is the IP address of the Identity Vault. In a NAT environment, this might be the address of the intermediate NAT device that routes the connection request to the Identity Vault. |
Use legacy ID-server schema? |
False |
Enables the backward compatibility mode when migrating an existing ID-Server configuration to run with the new ID Provider driver. Setting this to True allows you to keep using legacy ID policies, which do not use the new schema that ships with the ID Provider. |
Trace level |
ALL |
This is not the driver trace level, but the ID Provider trace level. The levels are:
|
After the driver object is created in Designer, it must be deployed into the Identity Vault.
In Designer, open your project.
In the Modeler, right-click the driver icon or the driver line, then select
.If you are authenticated to the Identity Vault, skip to Step 5; otherwise, specify the follow information:
Host: Specify the IP address or DNS name of the server hosting the Identity Vault.
Username: Specify the DN of the user object used to authenticate to the Identity Vault.
Password: Specify the user’s password.
Click
.Read the deployment summary, then click
.Read the successful message, then click
.Click
to assign rights to the driver.The driver requires rights to objects within the Identity Vault and to the input and output directories on the server. The Admin user object is most often used to supply these rights. However, you might want to create a DriversUser (for example) and assign security equivalence to that user. Whatever rights that the driver needs to have on the server, the DriversUser object must have the same security rights.
Click
, then browse to and select the object with the correct rights.Click
twice.Click
to exclude users that should not be synchronized.You should exclude any administrative User objects (for example, Admin and DriversUser) from synchronization.
Click
.When a driver is created, it is stopped by default. To make the driver work, you must start the driver and cause events to occur. Identity Manager is an event-driven system, so after the driver is started, it won’t do anything until an event occurs.
To start the driver:
In Designer, open your project.
In the Modeler, right-click the driver icon or the driver line, then select
.For information about management tasks for the driver, see Section 6.0, Managing the ID Provider Driver.