Adding the AssureAccess Servlet Filter to the WLS 8.1 WebLogic Server Examples (18-Jul-2005)

Versions Affected

This Tech Note applies to versions 3.0 through 3.0.8.

Problem

Out of the box, AssureAccess 3.0.8 does not support WebLogic Server 8.1. Integrated support for 8.1 is included in AssureAccess version 3.0.9.

Solution

Upgrade to version 3.0.9 or configure earlier versions as follows.

For versions 3.0 through 3.0.8, configure AssureAccess using the following steps:

1. Install AssureAccess with a single root domain.



2. Start AssureAccess.



3. Make sure that BEA WebLogic Server (WLS) WLS 8.1 is not running.



4. Run the AssureAccess Local Configuration Utility from the Windows Programs Menu. A dialog box similar to the one in the following illustration appears.
   
   
   




5. In the WebLogic Server Install Root text box, add the path to the WLS 8.1 root directory (for example C:\bea).



6. Click Continue.
   
   
7. Click J2EE Adapter.



8. Enter the following under WebLogic Start Script:
   
   <InstallDir>\weblogic81\samples\domains\examples\startExamplesServer.cmd
   
   where <InstallDir> is the installation directory.
   
   For example, enter:
   C:\bea\weblogic81\samples\domains\examples\startExamplesServer.cmd



9. Save the configuration.



10. Remove the file AASecurityProvider.jar from <InstallDir>\weblogic81\server\lib\mbeantypes.
    
    You must repeat this step every time you save the configuration. The jar file represents a WLS 7.x and prior security provider. Since WLS 8.1 does not support the early version of the security provider, you must remove this file. (There will be a future update to AssureAccess to add an 8.1 security provider.)



11. Add the filter config to the top of <InstallDir>\weblogic81\samples\server\examples\build\examplesWebApp\WEB-INF\web.xml.
    
    In the following code fragment example, the code highlighted in blue is the filter config.
    
    
    <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
    
    <web-app>
    
    <!-- AssureAccess servlet filter -->
    
    <filter>
       <filter-name>AAFilter</filter-name>
       <filter-class>com.entegrity.assureaccess.j2ee.servlet.AAFilter</filter-class>
       <init-param>
       <param-name>SecurityDomainName</param-name>
       <param-value>/</param-value>
    </init-param>
    </filter>
    
    <filter-mapping>
       <filter-name>AAFilter</filter-name>
       <url-pattern>/*</url-pattern>
    </filter-mapping>
    
    <display-name>Examples Web Application</display-name>
    <servlet>
       <servlet-name>PhoneServlet</servlet-name>
       <servlet-class>examples.servlets.PhoneServlet</servlet-class>
         <init-param>
         <param-name>phonelist</param-name>
         <param-value>C:/bea/weblogic81/samples/server/examples/src/examples/servlets/phonelist</param-value>
         </init-param>
    
    
    (and so on)
    



12. Install the Sun Unlimited Strength Crypto Option for the installed JRE, as follows:
    
    a. Open the current examples server log in <InstallDir>\weblogic81\samples\domains\examples\examplesServer
    b. Verify the location of the JR. By default, it is <InstallDir>\jdk142_05\jre.
    c. Install the Sun Unlimited Strength Crypto entitled Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files 1.4.2. You can find this at the bottom of http://java.sun.com/j2se/1.4.2/download.html.
    
    During installation, two files are placed in <InstallDir>\jdk142_05\jre\lib\security. These files are local_policy.jar and US_export_policy.jar.
    
    
13. Change directory to
    <InstallDir>\weblogic81\samples\domains\examples
    
    This location is typically
    C:\bea\weblogic81\samples\domains\examples
    
    Note: The Server Examples start script must be run from this directory.
    
    
14. Start the examples server:
    
    startExamplesServer.cmd