NonStop SOAP 4.1 User's Manual

Table 24 WS-Security Sample Programs Directory (continued)
DescriptionDirectory
This directory contains the source of sample password provider library
that can be used to retrieve the password for UserNameToken and
for a private key.
Password Provider :
./extensible_modules/password_provider
This directory contains the source of a sample authentication provider
library. The developer can customize the validation of UserNameToken
by using this library.
Authentication Provider :
./extensible_modules/authn_provider
This directory contains all the certificates and private keys that are
used in the samples. The files with the extension .pem contain the
Keys : ./keys
private key. The files with the extension .cert contain the certificate
that has the public key.
This directory contains the data files, such as passwords that are used
in the samples.
Data : ./data
This script sets up the client repository that is needed to run the client
program.
setup.sh
This script secures the client and service based on the given scenario
number and then runs the client program.
run_scenario.sh
This file is used by the client program to engage the rampart module.
client_axis2.xml
This file has the instructions to run the sample programs.
README
Functionality of the Sample Client and Server Program
The client builds a "Hello" request message and secures the message by using policies defined
in the policy.xml file. Then, the client invokes the secured service and prints the response to the
console. The client uses Axis2c Rampart module to secure the messages.
The server is an echo server. It responds with the same text it receives from the client. The response
message is secured by using the policies defined in the services.xml. The server also uses
Axis2c Rampart module to secure the messages.
Running the Web Services Security Sample Programs
Perform the following steps to run the sample WS-Security sample programs:
1. Set the NSSOAP_HOME environment variable to <NonStop SOAP 4 Installation
Directory>.
2. cd <NonStop SOAP 4 Installation Directory>/sample_services/sec_echo
3. ./setup.sh
This script sets up the client repository that is needed to run the Web service security client
program. Then, this script copies all the WS-Security scenarios. This script also copies source
files of client and server program, password provider library, and authentication provider
library.
The script will ask for a path to set up the repository.
4. cd <the directory where the client repository is created>/sample_services/sec_echo.
5. Set the AXIS2C_HOME environment variable to <NonStop SOAP 4 Deployment
Directory>.
This environment variable is used to create and secure the sample service program.
6. ./run_scenario.sh <NSSOAP 4 server URL> <scenario no>
Here, <NSSOAP 4 server URL> is the URL where the Non Stop SOAP 4 server is deployed.
For example, http://15.146.233.43:1434/axis2c.
280 WS–Security in NonStop SOAP 4