Using the OIM 11g R1 API

Version: Oracle Identity Manager 11g R1
Description: This guide shows how to set up and use the Oracle Identity Manager 11g R1 API in a Java application.

1. Here are the files needed to use the OIM client:
   

    oimclient.jar
    commons-logging.jar
    eclipselink.jar
    spring.jar
    authwl.conf
    wlfullclient.jar



2. The first four files can be found in "oimclient.zip", which is located in "<oim_home>/server/client" directory.  Look in the "lib" and "conf" directories.
   
   ?

   1 2	cd /home/oracle/Oracle/Middleware/Oracle_IDM1/server/client unzip oimclient.zip



3. The "wlfullclient.jar" has to be generated.
   
   ?

   1 2	cd /home/oracle/Oracle/Middleware/wlserver_10.3/server/lib/ java -jar /home/oracle/Oracle/Middleware/modules/com.bea.core.jarbuilder_1.6.0.1.jar



4. "authwl.conf" can be found in "<oim_home>/designconsole/config"
   
   ?

   1	cd /home/oracle/Oracle/Middleware/Oracle_IDM1/designconsole/config

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31

import oracle.iam.platform.OIMClient; import java.util.Hashtable; import javax.security.auth.login.LoginException; import oracle.iam.identity.usermgmt.api.UserManager; import oracle.iam.platform.entitymgr.vo.SearchCriteria;   /**  * This class shows how to use the OIM APIs.  */ public class OracleIdentityManager {     public static void main(String[] args) throws LoginException     {         String ctxFactory = "weblogic.jndi.WLInitialContextFactory";         String oimServerURL = "t3://localhost:14000";         String authwlConfigPath = "/home/oracle/oimClient_lib/conf/authwl.conf"; //The authwl.conf file can be found the designconsole directory which is in MW_HOME/Oracle_IDM1         String username = "xelsysadm"; //OIM User Login         String password = "Password1"; //OIM User Password           System.setProperty("java.security.auth.login.config", authwlConfigPath);         Hashtable<string,string> env = new Hashtable<string,string>();         env.put(OIMClient.JAVA_NAMING_FACTORY_INITIAL, ctxFactory);         env.put(OIMClient.JAVA_NAMING_PROVIDER_URL, oimServerURL);         OIMClient oimClient = new OIMClient(env);         oimClient.login(username, password.toCharArray()); //login to OIM           //Accessing Oracle Identity Manager Services         UserManager userManager = oimClient.getService(UserManager.class);         oimClient.logout(); //Logout User from OIM Client     } }