Installing the OIM Integration Web Application

The integration is achieved by deploying a small web application in the application server that hosts OIM. IdentityIQ communicates with the web services contained in this application to read and write account information. Configuration of the OIM integration requires the username and password of the OIM administrator or another user with sufficient permissions.
You must first deploy the OIM Integration Servlet web application to the application server hosting the OIM application. The iiq.war file for this web application is contained in the IdentityIQ distribution as $INSTALLDIR/integration/OIM/iiqIntegration-OIM.jar or in the distribution for an IdentityIQ patch in a .jar file named Integration-oim-<version>.jar.

The iiqIntegration-OIM.jar file contains iiq.war file. You can customize the iiq.war file in many ways before being deployed into the application server hosting OIM.

Note
Ensure that if you are deploying web application as war file, it should be named as iiq.war. If you are deploying the web application from a directory, then directory must be named as iiq.

Following are the required customization steps:

  1. Configure access to OIM by modifying WEB-INF/classes/xellerate.properties to set.

    • XL.HomeDir: the full path to the directory where OIM is installed

    • userName: the OIM administrator that has the appropriate permission to read and write user and account data

    • password: the password for the OIM administrator

    For more information on the other properties that need to be set in xellerate.properties file, see Properties that can be defined in xellerate.properties .

  2. Copy OIM_ORACLE_HOME/designconsole/lib/oimclient.jar API implementation file from the OIM installation into the WEB-INF/lib directory of the integration application.