Benefits and Features of the Integration

17-2 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager 3. Removedelete all old OAAM jar files.

17.3 Migrating Native SOAP Applications to OAAM 11g

The web application communicates with OAAM via Web Services. Follow the procedures in this section to migrate your native SOAP application to OAAM 11g.

17.3.1 Use OAAM Shared Library Instead of Static Linking to OAAM Jars

To use the Oracle Adaptive Access Manager Shared Library, you must refer to the shared library by adding the following entry to your WebLogic deployment descriptor file, weblogic.xml: library-ref library-nameoracle.oaam.libslibrary-name library-ref

17.3.2 Move All Configurable Properties into the bharosa_server.properties File

As part of migrating the application, you must perform these steps: 1. Move all the configurable properties to bharosa_server.properties. 2. Make sure the following properties are set in bharosa_server.properties: ■ vcrypt.tracker.soap.useSOAPServer=true ■ vcrypt.soap.disable=false ■ bharosa.config.impl.classname=com.bharosa.common.util.Bharos aConfigPropsImpl ■ bharosa.config.load.impl.classname=com.bharosa.common.util.B harosaConfigLoadPropsImpl 3. Removedelete all other OAAM property files from the native application 4. Removedelete all old OAAM jar files

17.3.3 Configure SOAPWebServices Access

For details on configuring SOAPWebServices Access, refer to Configuring SOAP Web Services Access in the Oracle Fusion Middleware Administrators Guide for Oracle Adaptive Access Manager.

17.4 Migrating Native Applications that Cannot Use OAAM Shared Library

The process below covers migrating your existing 10.1.4.5 Natively Integrated application that is currently using SOAP authentication to 11g.

17.4.1 Use the OAAM 11g Jar Files

After those files are copied, you can copy the oaam_core.jar file from the ORACLE_HOMEoaamclilib folder into your applications library directory. ORACLE_HOME is usually the ORACLE_IDM1 folder in the Middleware Home. Migrating Native Applications to OAAM 11g 17-3

17.4.2 Copy the OAAM 11g Property Files

All updated property files and libraries are located in the ORACLE_ HOMEoaamcli folder. The confbharosa_properties folder contains the updated properties, and the lib folder contains the updated libraries. To upgrade your existing natively integrated application, you can start by removing the contents of your existing bharosa_properties folder, and replacing them with the contents of the ORACLE_HOMEoaamcliconfbharosa_properties directory.

17.4.3 Specify the Configurable Properties in the bharosa_server.properties File

In 10g all client specific configuration overrides were created in the bharosa_ client.properties file, now those overrides need to be created in the bharosa_ server.properties file. This was typically the file modified on the server side for the same purpose. A bharosa_server.properties file that contains the contents of your old bharosa_client.properties with the addition of the following new properties needs to be created in your applications bharosa_properties folder that contains the following information: New Properties vcrypt.tracker.soap.useSOAPServer=true vcrypt.soap.disable=false bharosa.config.impl.classname=com.bharosa.common.util.BharosaCon figPropsImpl bharosa.config.load.impl.classname=com.bharosa.common.util.Bharo saConfigLoadPropsImpl These new properties will tell the new libraries to use the Generic SOAP implementation classes for communicating with the OAAM Server component, and instead of looking to the OAAM database to read the properties typically retrieved from the BharosaConfig class to retrieve them from the local property files. It is noted above that these properties are to be used in addition to the existing contents of your bharosa_client.properties file which should include your soap user name, and soap keystore information. Note: If you did not have SOAP authentication setup in 10g, you will need to refer to Setting Up Encryption in the 10.1.4.5 Oracle Adaptive Access Manager Installation and Configuration Guide for creating a SOAP keystore for use with the new 11g environment.