Configuring EAServer and enabling XML-Security

EAServer must be configured with the necessary JAR files for your XML-Secure enabled Web service to work properly.

Enabling XML-Security

1. Follow the instructions to locate and download the xml-security-bin-1_0_4.zip file (which contains the following JAR files) from the XML-Security package and install them in either $JAGUAR/java/classes (UNIX), or %JAGUAR%\java\classes (Windows):

   • • junit3.7.jar – do not install this JAR file, since one is installed as part of your EAServer installation.

     • xalan.jar – verify that no other xalan.jar file is set in the EAServer classpath, otherwise you may experience class conflicts.

     • xml-apis.jar

     • log4j-1.2.5.jar – do not install this JAR file, since one is installed as part of your EAServer installation.

     • xercesImpl.jar

     • xmlParserAPIs.jar

     • xmlsec.jar

     • xmlsecSamples.jar

     • xmlsecTests.jar

2. Update the EAServer classpath/bootclasspath to use the XML-Security JAR files:

   • For Win2k/WinXP:Edit %JAGUAR%\bin\user_setenv.bat (create one if necessary) and add these lines:

     set JC=..\java\classes
     set EAS_CLASSPATH_P0=%JC%\junit.jar
     set EAS_CLASSPATH_P0=%EAS_CLASSPATH_P0%;%JC%\log4j.jar
     set EAS_CLASSPATH_P0=%EAS_CLASSPATH_P0%;%JC%\xmlsec.jar
     set EAS_CLASSPATH_P0=%EAS_CLASSPATH_P0%;%JC%\xalan.jar
     set EAS_CLASSPATH_P0=%EAS_CLASSPATH_P0%;%JC%\xercesImpl.jar
     set EAS_CLASSPATH_P0=%EAS_CLASSPATH_P0%;%JC%\xml-apis.jar
     set EAS_CLASSPATH_P0=%EAS_CLASSPATH_P0%;%JC%\xmlParseAPIs.jar
     set EAS_BOOTCLASSPATH_P0=%EAS_CLASSPATH_P0%
     

   • For UNIX:

     Edit $JAGUAR/bin/user_setenv.sh (create one if necessary), and add these lines:

     JC=../java/classes
     EAS_CLASSPATH_P0=$JC/junit.jar
     EAS_CLASSPATH_P0=$EAS_CLASSPATH_P0;$JC/log4j.jar
     EAS_CLASSPATH_P0=$EAS_CLASSPATH_P0;$JC/xmlsec.jar
     EAS_CLASSPATH_P0=$EAS_CLASSPATH_P0;$JC/xalan.jar
     EAS_CLASSPATH_P0=$EAS_CLASSPATH_P0;$JC/xercesImpl.jar
     EAS_CLASSPATH_P0=$EAS_CLASSPATH_P0;$JC/xml-apis.jar
     EAS_CLASSPATH_P0=$EAS_CLASSPATH_P0;$JC/xmlParseAPIs.jar
     EAS_BOOTCLASSPATH_P0=$EAS_CLASSPATH_P0
     

   By setting the EAS_CLASSPATH_PO variable, you modify the server startup script to place the XML-Security jars in the server classpath/bootclasspath first.

3. Shutdown and restart EAServer.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF