You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ws.apache.org by co...@apache.org on 2014/02/28 17:19:24 UTC

svn commit: r1572985 - in /webservices/wss4j/site/src/site: site.xml xdoc/user_guide.xml xdoc/using.xml

Author: coheigea
Date: Fri Feb 28 16:19:23 2014
New Revision: 1572985

URL: http://svn.apache.org/r1572985
Log:
Adding small section on WS-SecurityPolicy to the user guide

Modified:
    webservices/wss4j/site/src/site/site.xml
    webservices/wss4j/site/src/site/xdoc/user_guide.xml
    webservices/wss4j/site/src/site/xdoc/using.xml

Modified: webservices/wss4j/site/src/site/site.xml
URL: http://svn.apache.org/viewvc/webservices/wss4j/site/src/site/site.xml?rev=1572985&r1=1572984&r2=1572985&view=diff
==============================================================================
--- webservices/wss4j/site/src/site/site.xml (original)
+++ webservices/wss4j/site/src/site/site.xml Fri Feb 28 16:19:23 2014
@@ -12,7 +12,7 @@
     <menu name="Apache WSS4J">
       <item name="Home" href="index.html"/>
       <item name="Download" href="download.html"/>
-      <item name="WSS4J User Guide" href="user_guide.html"/>
+      <item name="User's Guide" href="user_guide.html"/>
     </menu>
 
     <menu ref="reports"/>

Modified: webservices/wss4j/site/src/site/xdoc/user_guide.xml
URL: http://svn.apache.org/viewvc/webservices/wss4j/site/src/site/xdoc/user_guide.xml?rev=1572985&r1=1572984&r2=1572985&view=diff
==============================================================================
--- webservices/wss4j/site/src/site/xdoc/user_guide.xml (original)
+++ webservices/wss4j/site/src/site/xdoc/user_guide.xml Fri Feb 28 16:19:23 2014
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <document>
 <body>
-<section name="Apache WSS4J User Guide">
+<section name="Apache WSS4J User's Guide">
 <p>
 Click on the links below for more information about the functionality offered
 by WSS4J and how to configure it.

Modified: webservices/wss4j/site/src/site/xdoc/using.xml
URL: http://svn.apache.org/viewvc/webservices/wss4j/site/src/site/xdoc/using.xml?rev=1572985&r1=1572984&r2=1572985&view=diff
==============================================================================
--- webservices/wss4j/site/src/site/xdoc/using.xml (original)
+++ webservices/wss4j/site/src/site/xdoc/using.xml Fri Feb 28 16:19:23 2014
@@ -145,6 +145,23 @@ below. See the CXF configuration <a href
 </subsection>
 
 <subsection name="WS-SecurityPolicy based approach">
+<p>
+The recommended way of applying WS-Security to your web services is to use
+WS-SecurityPolicy. The WS-SecurityPolicy specification defines a set of
+WS-Policy expressions that can be used to define the security requirements of
+a web service. Typically one or more policies are attached to the WSDL of a
+service, which conveys the security requirements of the service to the client.
+A WS-SecurityPolicy aware stack such as Apache CXF or Apache Axis/Rampart can
+parse the policies and configure WSS4J appropriately. This greatly simplifies
+things for the user, who then only has to supply some basic information about
+which users, CallbackHandlers, Crypto property files, etc. to use.
+</p>
+<p>
+For more information on using WS-SecurityPolicy with WSS4J, please see CXF's
+WS-SecurityPolicy page, or go to the SOAP stack sections below:
+<a href="http://cxf.apache.org/docs/ws-securitypolicy.html">CXF
+WS-SecurityPolicy configuration</a>
+</p>
 
 </subsection>