Author: dkulp
Date: Sat Mar 14 03:30:49 2009
New Revision: 753597
URL: http://svn.apache.org/viewvc?rev=753597&view=rev
Log:
Update the readme for the interop samples
Modified:
cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt
Modified:
cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt
URL:
http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt?rev=753597&r1=753596&r2=753597&view=diff
==============================================================================
---
cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt
(original)
+++
cxf/trunk/distribution/src/main/release/samples/ws_security/interopfest/README.txt
Sat Mar 14 03:30:49 2009
@@ -1,4 +1,4 @@
-About these samples:
+*** About these samples ***
This CXF sample is being used to help implement WS-SecurityPolicy,
WS-SecureConversation, and WS-Trust within CXF.
@@ -11,13 +11,26 @@
[2] http://131.107.72.15/ilab/WSSecurity/WCFInteropPlugFest_Security.doc
-**** Running the WS-Security samples:
+*** Requirements ***
-Since these projects rely on the SNAPSHOT (2.2) version of CXF, you'll need
-to check out CXF from svn first and build[3] the CXF project.
+The samples in this directory use STRONG encryption. The default encryption
algorithms
+included in a JRE is not adequate for these samples. The Java Cryptography
Extension
+(JCE) Unlimited Strength Jurisdiction Policy Files available on Sun's JDK
download
+page[3] *must* be installed for the examples to work. If you get errors
about invalid
+key lengths, the Unlimited Strength files are not installed.
-The wssec11 project can be run by entering mvn clean install from the
-wssec11 folder, and then entering the following command:
+[3] http://java.sun.com/javase/downloads/index.jsp
+
+
+*** Running the WS-Security samples against the Microsoft servers ***
+
+Each of the samples are setup to test a CXF client against the public servers
provided
+by Microsoft. To build and run the client, run:
+
+mvn -Pclient
+
+This will download the WSDL and Certs from Microsoft, build the code, and runs
the client
+testing all the known working test cases. If you want to run a specific
test, run:
mvn -Pclient -Dtest.method=XX
@@ -27,12 +40,16 @@
wsdl:port under the wsdl:service element in the WSDL above). So
-Dtest.method=UX will
call the UX_IPingService listed in the WSDL.
-SOAP clients for these web services are in the process of being developed and
tested, but not
-yet CXF-based web service providers implementing these services. Help is most
welcome.
-Note: The Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction
Policy Files
-available on Sun's JDK download page[4] *must* be installed for the examples
to work.
+*** Running the WS-Security samples against the local CXF servers ***
+
+The wssec10, wssec11, and wssc samples contain working CXF servers. (The
WS-Trust
+samples do not yet have working servers.) To start the server, just run:
+
+mvn -Pserver
+
+
+To run the CXF clients agains the local server, run:
-[3] http://cxf.apache.org/building.html
-[4] http://java.sun.com/javase/downloads/index.jsp
+mvn -Pclient -Dtest.server=local
