Configuring the environment for SOAP security

SOAP security profiles require access to the libraries that implement encryption, signature, and other security algorithms that transform the XML messages before sending and after receiving them. You must prepare an environment with these libraries to use SOAP security, set the class path of the Java™ Runtime Environment (JRE) that Eclipse uses, and set the class path of the virtual machine that the Agent Controller uses.

Before you begin

Before you can test SOAP-based services that use security algorithms, you must obtain a set of security libraries and configuration files for SOAP.

BouncyCastle ( is a provider of such security libraries. Use of these security libraries is optional for the Rational® test product.


  1. Copy the library files into the jre/lib/ext of the JRE installation.

    By default, this is the following directory: C:\Program Files\HCL\HCLProducts\jdk\jre\lib\ext

  2. Add the following VM argument either to the Eclipse launch command line or to the eclipse.ini file: -vmargs -Dosgi.parentClassloader=ext

    The eclipse.ini file is located in the same directory as the eclipse.exe launcher binary that is used to run the product.

What to do next

To configure a remote computer that uses only the Agent Controller and does not require access to the workbench, perform only step 1 and restart the Agent Controller service.

After configuring the environment, you must import a Web Services Description Language (WSDL) file and use the WSDL security editor to set up a security profile for the WSDL file.