OIM API Usage

OIM是Oracle出品的一個身份管理解決方案，提供了API可以給第三方程序調用。今天嘗試了一下如何從OIM外部調用API，並調用API完成用戶註冊功能。

 

使用的產品是OIM10g，具體版本號是9.1.0.2。具體的步驟我就不寫了，這一部分Oracle寫的還是比較多。

 

簡單步驟如下：

1、先用Eclipse建立一個工程，將OIM相關類引入，按照你的要求編寫一個API調用程序，並導出爲jar包，比如：oimtest.jar

2、從安裝好的OIM Design Console中找到CustomClient.zip，並解壓。

3、解壓後，要將OIM Design Console安裝目錄下的ext和lib兩個目錄的內容copy到解壓後的CustomClient目錄下，覆蓋原有的內容。

4、安裝文檔 中說的修改相應部分。

5、把oimtest.jar拷貝到CustomerClient下的lib目錄下，並在basecp或者classpath批處理文件中引用這個jar包

6、運行xlCustomClient.bat或者wsCustomClient.bat即可

 

由於時間不多不能寫出詳細的步驟，具體參考可以參考如下鏈接：

Using the Oracle Identity Manager API

http://download.oracle.com/docs/cd/E14049_01/doc.9101/e14058/chapter1.htm#sthref11

 

 

另外我寫的調用OIM API的代碼如下：

package xxx.xxx.oim.test; import java.text.DateFormat; import java.text.SimpleDateFormat; import java.util.Calendar; import java.util.Enumeration; import java.util.HashMap; import java.util.Hashtable; import Thor.API.tcResultSet; import Thor.API.tcUtilityFactory; import Thor.API.Exceptions.tcAPIException; import Thor.API.Exceptions.tcAttributeMissingException; import Thor.API.Exceptions.tcChallengeInfoException; import Thor.API.Exceptions.tcChallengeNotSetException; import Thor.API.Exceptions.tcColumnNotFoundException; import Thor.API.Exceptions.tcDuplicateSelfRegistrationException; import Thor.API.Exceptions.tcDuplicateUserException; import Thor.API.Exceptions.tcFormNotFoundException; import Thor.API.Exceptions.tcInvalidAttributeException; import Thor.API.Exceptions.tcInvalidLookupException; import Thor.API.Exceptions.tcInvalidManagerException; import Thor.API.Exceptions.tcInvalidValueException; import Thor.API.Exceptions.tcLoginAttemptsExceededException; import Thor.API.Exceptions.tcObjectNotFoundException; import Thor.API.Exceptions.tcOrganizationNotFoundException; import Thor.API.Exceptions.tcPasswordExpiredException; import Thor.API.Exceptions.tcPasswordResetAttemptsExceededException; import Thor.API.Exceptions.tcRequestInvalidException; import Thor.API.Exceptions.tcRequestNotFoundException; import Thor.API.Exceptions.tcRequestObjectInvalidException; import Thor.API.Exceptions.tcRequestOrganizationInvalidException; import Thor.API.Exceptions.tcRequiredDataMissingException; import Thor.API.Exceptions.tcUserAccountDisabledException; import Thor.API.Exceptions.tcUserAccountInvalidException; import Thor.API.Exceptions.tcUserAlreadyLoggedInException; import Thor.API.Operations.tcFormInstanceOperationsIntf; import Thor.API.Operations.tcLookupOperationsIntf; import Thor.API.Operations.tcObjectOperationsIntf; import Thor.API.Operations.tcOrganizationOperationsIntf; import Thor.API.Operations.tcPasswordOperationsIntf; import Thor.API.Operations.tcPropertyOperationsIntf; import Thor.API.Operations.tcRequestOperationsIntf; import Thor.API.Operations.tcUserOperationsIntf; import com.thortech.xl.crypto.tcCryptoException; import com.thortech.xl.crypto.tcCryptoUtil; import com.thortech.xl.crypto.tcSignatureMessage; import com.thortech.xl.dataaccess.tcDataProvider; import com.thortech.xl.util.config.ConfigurationClient; public class UserOperations { tcUserOperationsIntf userops; tcPropertyOperationsIntf propops; tcRequestOperationsIntf reqops; tcOrganizationOperationsIntf orgops; tcObjectOperationsIntf objops; tcFormInstanceOperationsIntf formops; tcLookupOperationsIntf lkupops; tcPasswordOperationsIntf pwdOps; public UserOperations() { } public tcUtilityFactory getAdminConnection() throws tcCryptoException, tcAPIException, tcUserAccountDisabledException, tcPasswordResetAttemptsExceededException, tcLoginAttemptsExceededException, tcUserAccountInvalidException, tcUserAlreadyLoggedInException, tcChallengeNotSetException, tcPasswordExpiredException { ConfigurationClient.ComplexSetting config = ConfigurationClient .getComplexSettingByPath("Discovery.CoreServer"); final Hashtable env = config.getAllSettings(); // tcSignatureMessage moSignature = // tcCryptoUtil.sign("xelsysadm","PrivateKey"); // tcUtilityFactory utilityFactory = new tcUtilityFactory(env, // moSignature); tcUtilityFactory utilityFactory = new tcUtilityFactory(env, "xelsysadm", "xxxxx"); return utilityFactory; } public void createRegistrationRequest() { ConfigurationClient.ComplexSetting config = ConfigurationClient .getComplexSettingByPath("Discovery.CoreServer"); final Hashtable env = config.getAllSettings(); try { tcUtilityFactory tcutil = getAdminConnection(); Hashtable quesAns = new Hashtable(); HashMap user = new HashMap(); user.put("Users.User ID", "SelfTesting"); user.put("Users.First Name", "SelfTesting"); user.put("Users.Last Name", "SelfTesting"); user.put("Users.Email", "[e-mail]"); user.put("Users.Password", "SelfTesting"); user.put("ConfirmPassword", "SelfTesting"); user.put("Organization", "test22"); tcUtilityFactory.createRegistrationRequest(env, user, quesAns); } catch (tcCryptoException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcAPIException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcUserAccountDisabledException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcPasswordResetAttemptsExceededException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcLoginAttemptsExceededException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcUserAccountInvalidException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcUserAlreadyLoggedInException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcChallengeNotSetException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcPasswordExpiredException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcDuplicateSelfRegistrationException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcRequiredDataMissingException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcChallengeInfoException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcOrganizationNotFoundException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcInvalidManagerException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (tcDuplicateUserException e) { // TODO Auto-generated catch block e.printStackTrace(); } } }