Quickstart Examples - Secure Invoke
===================================

NOTE: This example can only be used if the JBossWS-CXF stack has been installed
into the JBossAS application server. This is because RiftSaw leverages
CXF to provide the security features.


This is a slightly modified version of the simple_invoke example, which
sends a message to a BPEL process, which subsequently invokes a JAX-WS
based web service, before returning the response back to the client
application. This modified version adds security (authentication and
digital signature) to the invocation of the JAX-WS service.

The BPEL process, which is performing the role of the secure client,
has an additional CXF based configuration file, specific to the
service and port being invoked.

The configuration is named jbossws-cxf-{portname-localpart}.xml,
in this case jbossws-cxf-SecureHelloWorldPort.xml, and can be found
in the bpelContent sub-folder. The related signature properties and
keystore files can be found in the bpelContent/etc and bpelContent/keystore
sub-folders respectively.

The security configuration for the JAX-WS service can be found in the
war/resources/WEB-INF sub-folder. The jbossws-cxf.xml file configures the
CXF service endpoint, with the related files being located in the
etc and keystore sub-folders.

For further information on how to configure the security features,
please see the "Web Service Configuration" section of the User Guide.

To deploy the example, open a command line window in the example's folder,
and simply type 'ant deploy'. To undeploy, use the command 'ant undeploy'.

To test the example, for example using the SOAPUI client, an example message
can be found in the messages sub-folder, with the relevant WSDL being
located in the bpel sub-folder.

Alternatively, use the 'ant sendhello' command (from a command line window)
to send the example message directly to the deployed process.

NOTE: The "ant deploy" command will by default deploy version 1 of the
example to the server. If you wish to change the example, and redeploy,
then you will need to update the version number in the build.xml, or
override the version property, e.g. "ant -Dversion=2 deploy" (and similarly
when undeploying "ant -Dversion=2 undeploy").

Some handy URLs:
http://localhost:8080/bpel-console is the BPEL console
http://localhost:8080/Quickstart_bpel_secure_invokeWS?wsdl is the URL to the BPEL process' WSDL
http://localhost:8080/Quickstart_bpel_secure_invoke/SecureHelloWorldWS?wsdl is the JBossWS endpoint's WSDL
