12 Customizing Oracle Adaptive Access Manager

12.1 Overview

Shared libraries are collections of programming and data that can be used by multiple applications. They can permit applications to use memory efficiently by sharing common programming and resources.

You can customize Oracle Adaptive Access Manager by adding custom jars and files to the Oracle Adaptive Access Manager Extensions Shared Library.

This shared library, a war file named oracle.oaam.extensions, is deployed in both OAAM Server and OAAM Admin Server.

By default oracle.oaam.extensions.war is empty and does not contain any files except the MANIFEST.MF that has the definition of the shared library.

12.2 Add Customizations Using Oracle Adaptive Access Manager Extensions Shared Library

Follow these steps to add customizations to Oracle Adaptive Access Manager:

1. Create a work folder called oaam-extensions.

   The folder can be created anywhere as long as it is outside the installation folder.

2. In the oaam-extensions folder, create the following subfolders:

   • META-INF

   • WEB-INF

   • WEB-INF\lib

   • WEB-INF\classes

3. In the META-INF folder, create a file named MANIFEST.MF and add the following lines:

   Extension-Name: oracle.oaam.extensions
   Specification-Version:99.9.9.9.9
   Implementation-Version:99.9.9.9.9
   

4. Compile custom java classes that extend or implement Oracle Adaptive Access Manager classes, adding the jars from $ORACLE_IDM_HOME\oaam\cli\lib folder to the build class path.

5. Add custom jars and files as described:

   1. Add the custom jars to the oaam-extensions\WEB-INF\lib folder.

   2. Add custom properties to a file named bharosa_server.properties and save it in the oaam-extensions\WEB-INF\classes folder.

   3. Add custom JSPs to oaam-extensions folder.

6. Rejar oracle.oaam.extensions.war using the command from the parent folder of oaam-extensions:

   jar -cvfm oracle.oaam.extensions.war oaam-extensions\META-INF\MANIFEST.MF -C  oaam-extensions/ .
   

7. Start the WebLogic Server where Oracle Adaptive Access Manager is deployed and log into the WebLogic Administration Console.

8. Deploy the oracle.oaam.extensions.war file created in Step 6 as a Shared Library with oaam_server and oaam_admin as target applications.

9. Test the custom functionality and make sure files added to oracle.oaam.extensions.war are used by Oracle Adaptive Access Manager applications.