Installation Guides › SOA Agent for Web Servers Guide › Configure the SOA Agent to Work on an Oracle iPlanet Web Server › Manually Configure an Oracle iPlanet Web Server

Manually Configure an Oracle iPlanet Web Server

The SOA Security Manager Agent Configuration wizard only configures the default instance of your Oracle iPlanet web server. If you want to configure a different instance of the Oracle iPlanet web server to use SOA Security Manager, you need to manually edit the obj.conf file that is used by that server instance. Examples of server instances that need manual configuration include:

• Servers installed in a non-default directory
• Servers you want to configure as a reverse proxy (we recommend configuring the reverse proxy using your Oracle iPlanet interface before adding the SOA Security Manager settings to the obj.conf file).

  Note: The SOA Security Manager Agent Configuration wizard only modifies the default obj.conf file on the Oracle iPlanet (formerly Sun Java System) web server. To protect other instances or reverse proxy deployments with SOA Security Manager, copy the SOA Security Manager settings from the default obj.conf file to any respective instance_name-obj.conf files. For example, your web server created an obj.conf file when you installed it, but you later added a server instance named my_server.example.com. To protect resources on my_server.example.com with SOA Security Manager, copy the SOA Security Manager settings added by the wizard from the obj.conf file to the my_server.example.com-obj.conf file.

• Virtual servers on the same computer

To manually configure a Oracle iPlanet Web Server

1. Locate the directory of the server instance you want to configure.
2. Open the obj.conf file with a text editor.
3. Locate the following line:

   <Object name="default">
   

4. Insert a new line below the previous one, and then add the following text:

   AuthTrans fn="SiteMinderAgent"
   

5. Locate the following line:

   AuthTrans fn="match-browser" browser="*MSIE*" ssl-unclean-shutdown="true"
   

6. Insert a new line below the previous one, and then add the following text:

   NameTrans fn="pfx2dir" from="/siteminderagent/pwcgi" dir="web_agent_home/pw" name="cgi"
   NameTrans fn="pfx2dir" from="/siteminderagent/pw" dir="web_agent_home/pw"
   NameTrans fn="pfx2dir" from="/siteminderagent/jpw" dir="web_agent_home/jpw"
   NameTrans fn="pfx2dir" from="/siteminderagent/redirectjsp" dir="web_agent_home/affwebservices/redirectjsp"
   NameTrans fn="pfx2dir" from="/siteminderagent/certoptional" dir="web_agent_home/samples"
   NameTrans fn="pfx2dir" from="/siteminderagent" dir="web_agent_home/samples"
   

   agent_home

   Indicates the directory where the SOA Agent is installed.

   Default (Windows 32-bit installations of SOA Security Manager SOA Agents only): [set Access Path variable]\webagent

   Default (UNIX/Linux installations): [set the Installation Path variable]/webagent

   Default (Windows 64-bit installations [SOA Security Manager SOA Agents for IIS only]): [set Access Path variable]\webagent\win64

   Default (Windows 32-bit applications operating on 64-bit systems [Wow64 with SOA Security Manager SOA Agents for IIS only]): [set Access Path variable]\webagent\win32

7. Locate the following line:

   NameTrans fn="ntrans-j2ee" name="j2ee"
   

8. Insert a new line below the previous one, and then add the following text:

   PathCheck fn="SmRequireAuth"
   

9. Remove the following line:

   NameTrans fn="pfx2dir" from="/mc-icons" dir="C:/Program Files/Sun/WebServer7.0/lib/icons" name="es-internal"
   

10. Locate the following line:

    ObjectType fn="force-type" type="text/plain"
    

11. Insert a new line below the previous one, and then add the following text:

    Service method="(GET|POST)" fn="SmAdvancedAuth"
    

12. Save the obj.conf file.

    The Oracle iPlanet web server is configured.