This document guides you on how to install Rampart/C.
You must have OpenSSL 0.9.8 (or above) installed in you system.
This release comes in two forms, source and binary. This document covers both forms.
Please send your feedback to the developer mailing list: rampart-c-dev@ws.apache.org (Subscription details are available on the Rampart/C site.
This can be done using binary or source distributions. (Download the two distributions)
The following steps have to be followed to install and run the Rampart/C binary distribution on Linux :
%sh deploy_client_repo.sh
%sh test_scen.sh scenarioX server-port
The following steps have to be followed to install and run Rampart/C using the source distribution on Linux :
%sh build.sh
%sh test_scen.sh scenarioX server-port
This too can be done using binary or source distributions. (Download the two distributions.)
(Note: You can download the Microsoft VSExpress2005 edition and Platform SDK from the Microsoft Web site. You will need to add the path to the Platform SDK Include and Lib folders to the makefile)
The following steps will take you through the source compilation.
(Note: You may have to set the PATH environment variable to vcvars32.bat if MS Windows gives an error indicating that it cannot find this batch file. This file is located in <your MS Visual Studio install Directory>\VC\bin directory.)
You can engage Rampart/C in global level or in service level.
Just add the following entry either to axis2.xml(gloabl level) or in services.xml(service level) corresponding to the service you want to secure.
<module ref="rampart"/>
Also you need to add follwoing phase under <phaseOrder type="outflow">
<phaseOrder type="outflow"> <!-- Other Phases--> <phase name="Security"/> </phaseOrder>
Apart from that you must define security policies for the client and the server.
CLIENT SIDE:
In the client side just drop a policy.xml file to the same location(client-repo) where you have the axis2.xml.
SERVER SIDE:
Add WS-Security Policy assertions to the services.xml.
NOTE: Please find sample security policy files that are located under samples/secpolicy
You may go through each and every scenario and see how Rampart/C is configured using the policy assertions available in respective policy files.
For each scenario there are two files
NOTE: If you have changed a client's policy file, make sure that you change the corresponding policy assertions in the services.xml file as well, and vise versa.
NOTE: To try out samples, use the client available under samples/client/sec_echo
Usage: echo [address] [client_repo]