ICF 1.5.20.36

Remote connectors

In many cases, IDM bundles the connectors required to connect to remote resources and assumes the connector runs on the same host as IDM. Sometimes, a connector can’t run on the same host as IDM. This might be for security or network reasons or because IDM runs in the cloud while the resource is on-prem. Connectors that do not run on the same host as IDM are remote connectors. To run remotely, a connector needs a Remote Connector Server (RCS) that runs on the same host as the connector. IDM accesses the connector through the RCS.

Running connectors remotely requires the following high-level steps:

  1. Install an RCS and any dependencies required:

  2. (Optional) Download additional connectors to your RCS /path/to/openicf/connectors/ directory.

  3. Connect RCS to your system:

For a list of supported RCS versions, and compatibility between versions, refer to IDM / ICF Compatibility Matrix.

Install a Remote Connector Server (RCS)

There are two types of RCS:

  • Java: Use the Java RCS if your Java connector needs to run in a different JVM to IDM. You can also Deploy Java RCS in a Docker container. Unless the remote resource you’re connecting to needs the .NET PowerShell connector, this is the recommended RCS to use.

    The system where you install the Java RCS must run a supported JRE version. Disk space and memory requirements depend on the number of connectors you’re using and the volume of traffic through the RCS.

  • .NET: Use the .NET RCS if you are using the PowerShell connector to connect to an identity store. IDM communicates with the .NET RCS over the network and the RCS runs the PowerShell connector.

Install connector dependencies

Most ICF connectors come bundled with all necessary third-party libraries. Place any additional dependencies in:

  • /path/to/openidm/lib/ directory for IDM.

  • /path/to/openicf/lib/ directory for RCS.

The following table lists the connector dependencies and indicates which ones must be downloaded:

Dependencies for bundled connectors

Database Table connector

The JDBC driver for the target database.

PeopleSoft connector

lib/psft.jar

lib/psjoa.jar

SAP connector

lib/sapjco3.jar

lib/libsapjco3.so