2 Getting Started

This chapter describes the configuration of Oracle Identity Manager and installation of Remote Manager. It contains the following topics:

"Overview"

Overview

To construct adapter tasks, you need to make sure that Oracle Identity Manager has access to the target API jar files and third-party applications to which you want to connect.

When your adapter uses Java tasks, you must configure Oracle Identity Manager so that it can find the appropriate Java APIs. To do this, you need only place the .jar files that contain these APIs, into the JavaTasks sub-folder of the <XL_HOME>/Xellerate folder path (for example, C:\oracle\Xellerate\JavaTasks). Then, you will be able to access the java classes that are associated with these Java APIs and use them in the Java task you are creating.

Sometimes, instead of directly communicating with the third party system, Oracle Identity Manager must use an Oracle Identity Manager component that acts like a proxy. This component is known as Remote Manager.

The remote manager is used for:

Invoking non-remotable APIs through Oracle Identity Manager.
Invoking APIs that do not support SSL over secure connections.

The following procedures will show you how to:

Configure Oracle Identity Manager to reference jar and class files (for Java tasks).
Configure the Remote Manager.

Note:

For more information about Java tasks, refer to the "To Create a Java Task". To learn more about remote managers, refer to Oracle Identity Manager Administrative and User Console Guide.

Configure Oracle Identity Manager to Reference Jar and Class Files

Open the JavaTasks sub-folder, which can be found within the <XL_HOME>/Xellerate folder path (for example, C:\oracle\Xellerate\JavaTasks).
Place the jar file(s) into this sub-folder. Once this occurs, these files can be used to create Java tasks within an adapter, without restarting the server.

Installing Remote Manager

To configure Remote Manager, you first need to install the Remote Manager component. Refer to Oracle Identity Manager Installation Guide for instructions about how to install Remote Manager.

Adding the Trust Relation

To import a trusted certificate, at the command prompt, navigate to the following location:

<JAVA_HOME>\jre\lib\security

Enter the command:

<JAVA_HOME>/jre/bin/keytool -import -file 
<XLREMOTE_HOME>\xlremote\config\xlserver.cert -keystore cacerts -trustcacerts -
alias rmtrust1 -storepass changeit

Owner: CN=Customer, OU=Customer, O=Customer, L=City, ST=NY, C=US
Issuer: CN=Customer, OU=Customer, O=Customer, L=City, ST=NY, C=US
Serial number: 41dee35a
Valid from: Fri Jan 07 11:30:34 PST 2005 until: Mon Jan 05 11:30:34 PST 2015
Certificate fingerprints:
         MD5:  B0:F2:33:C8:69:E4:25:A3:CB:59:E8:51:27:EE:5C:52
         SHA1: 3D:6A:6D:14:33:B5:5C:19:85:CC:EE:77:7F:7F:22:1D:56:48:47:4D
Trust this certificate? [no]:  yes

The certificate is added to the keystore.