Web Agent Guides › Web Agent Configuration Guide › Configure Reverse Proxy Servers › How Reverse Proxy Servers Work with SiteMinder › SiteMinder Reverse Proxy Deployment Considerations › Configure a Sun Java System 6.0 Reverse Proxy Server

Configure a Sun Java System 6.0 Reverse Proxy Server

You can use a Sun Java System 6.0 Web server as a reverse proxy with SiteMinder.

To configure a Sun Java System Web server as a reverse proxy

1. Navigate to the following directory:

   web_server_installation_directory/plugins
   

2. Create the following subdirectories:

   \passthrough\bin
   

3. Add the one of the folloiwng files to the passthrough\bin directory:
   • passthrough.dll (Windows)
   • libpassthrough.so (UNIX)

   Note: Download the Sun Java System Web Server Reverse Proxy Add-On 6.1 file from Sun Microsystems.

4. Add the one of the following sections to your web_server_installation_directory/config/magnus.conf file:
   • Windows

     Init fn="load-modules" shlib="web_server_installation_directory/plugins/passthrough/bin/passthrough.dll" funcs="init-passthrough,auth-passthrough,check-passthrough,service-passthrough" NativeThread="no"

     Init fn="init-passthrough"

   • UNIX

     Init fn="load-modules" shlib="web_server_installation_directory/plugins/passthrough/bin/libpassthrough.so" funcs="init-passthrough,auth-passthrough,check-passthrough,service-passthrough" NativeThread="no"

     Init fn="init-passthrough"

   Note: All lines must start with Init. Any settings that follow must continue on the same line.

5. Create a passthrough object by adding the following section to top of the config/obj.conf file:

   <Object name="passthrough">
   ObjectType fn="force-type" type="magnus-internal/passthrough"
   Service type="magnus-internal/passthrough" fn="service-passthrough" servers="http://server_name:port"
   Error reason="Bad Gateway" fn="send-error" uri="$docroot/badgateway.html"
   </Object>
   

6. Configure which URIs are to be forwarded by adding a section similar to the following to the top of the default object in the server_install_directory/config/obj.conf file:

   NameTrans fn="assign-name" from="(/uri|/uri/*)" name="passthrough"
   

   The URI is the context root of a web application deployed on the remote servers, and passthrough corresponds to the name of the <Object> in the obj.conf file, as shown in the following example:

   <Object name="default"> 
   ... 
   NameTrans fn="assign-name" from="(/webapp1|/webapp1/*)" name="passthrough" 
   ... 
   </Object>
   

   The name value should match the value of the object name used in Step 5.

7. Restart the Web server.

   The reverse proxy is configured.