From riftsaw-commits at lists.jboss.org Tue Jun  1 07:25:01 2010
Content-Type: multipart/mixed; boundary="===============5438645029765638723=="
MIME-Version: 1.0
From: riftsaw-commits at lists.jboss.org
To: riftsaw-commits at lists.jboss.org
Subject: [riftsaw-commits] riftsaw SVN: r688 -
 trunk/docs/docbook/userguide/src/main/module.
Date: Tue, 01 Jun 2010 07:25:01 -0400
Message-ID: <201006011125.o51BP1TC029247@svn01.web.mwc.hst.phx2.redhat.com>

--===============5438645029765638723==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: objectiser
Date: 2010-06-01 07:25:01 -0400 (Tue, 01 Jun 2010)
New Revision: 688

Modified:
   trunk/docs/docbook/userguide/src/main/module/wsconfig.xml
Log:
RIFTSAW-75 - added some documentation for how to provide cxf configuration =
details in the BPEL deployment.

Modified: trunk/docs/docbook/userguide/src/main/module/wsconfig.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- trunk/docs/docbook/userguide/src/main/module/wsconfig.xml	2010-05-31 12=
:23:39 UTC (rev 687)
+++ trunk/docs/docbook/userguide/src/main/module/wsconfig.xml	2010-06-01 11=
:25:01 UTC (rev 688)
@@ -90,4 +90,226 @@
        		=

        </section>
        =

+       <section>
+       		<title>Apache CXF Configuration</title>
+       		=

+       		<para>
+       		RiftSaw integrates with JBossWS, using the JAX-WS standard API, t=
o support the
+       		following web service stacks: JBossWS native, Metro and Apache CX=
F. This section
+       		explains how RiftSaw deployed BPEL processes can include addition=
al configuration
+       		specifically applicable to the Apache CXF web service stack - and=
 is therefore
+       		only relevant if the JBossAS application server has been configur=
ed to use this
+       		stack. See the <emphasis>Getting Started Guide</emphasis> for inf=
ormation on how to
+       		switch to the Apache CXF stack when installing RiftSaw.
+       		</para>
+       		=

+       		<para>
+       		This section will explain how web service endpoints, whether serv=
er (i.e. representing
+       		the BPEL process) or client (i.e. being used to invoke external w=
eb services), are
+       		configured using the Apache CXF configuration format. It will als=
o discuss reasons
+       		why you may wish to do this additional CXF specific configuration=
. However, for further
+       		information on how to configure CXF, and the features that it off=
ers, the reader is
+       		referred to the Apache CXF website <ulink url=3D"http://cxf.apach=
e.org/">http://cxf.apache.org</ulink>.
+       		</para>
+       		=

+       		<section>
+      			<title>Configuring the Server endpoint</title>
+      			=

+      			<para>
+      			To create a CXF configuration that will be used by the RiftSaw we=
b service provider
+      			(i.e. the server), it is simply a case of placing a file called
+      			<filename>jbossws-cxf.xml</filename> into the root folder of the =
BPEL deployment
+      			(along side the deployment descriptor).
+      			</para>
+      			=

+      			<para>
+      			This is the same filename as used by jbossws-cxf, when deploying =
a web service based
+      			on the use of JAXWS annotations. An example of the file content i=
s:
+      			</para>
+      			=

+			<informalexample>
+  				<programlisting role=3D"XML" ><![CDATA[
+<beans
+  xmlns=3D'http://www.springframework.org/schema/beans'
+  xmlns:xsi=3D'http://www.w3.org/2001/XMLSchema-instance'
+  xmlns:beans=3D'http://www.springframework.org/schema/beans'
+  xmlns:jaxws=3D'http://cxf.apache.org/jaxws'
+  xsi:schemaLocation=3D'http://cxf.apache.org/core
+    http://cxf.apache.org/schemas/core.xsd
+    http://www.springframework.org/schema/beans
+    http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
+    http://cxf.apache.org/jaxws
+    http://cxf.apache.org/schemas/jaxws.xsd'>
+  =

+  <bean id=3D"UsernameTokenSign_Request"
+  			class=3D"org.apache.cxf.ws.security.wss4j.WSS4JInInterceptor">
+    <constructor-arg>
+      <map>
+        <entry key=3D"action" value=3D"UsernameToken Timestamp Signature"/=
> =

+        <entry key=3D"passwordType" value=3D"PasswordDigest"/>
+	    <entry key=3D"user" value=3D"serverx509v1"/>
+        <entry key=3D"passwordCallbackClass"
+        		value=3D"org.jboss.test.ws.jaxws.samples.wsse.ServerUsernamePass=
wordCallback"/> =

+        <entry key=3D"signaturePropFile" value=3D"etc/Server_SignVerf.prop=
erties"/>
+        <entry key=3D"signatureKeyIdentifier" value=3D"DirectReference"/>
+      </map>
+    </constructor-arg>
+  </bean>
+  =

+  <bean id=3D"UsernameTokenSign_Response"
+  			class=3D"org.apache.cxf.ws.security.wss4j.WSS4JOutInterceptor">
+    <constructor-arg>
+      <map>
+        <entry key=3D"action" value=3D"UsernameToken Timestamp Signature"/=
> =

+        <entry key=3D"passwordType" value=3D"PasswordText"/>
+	    <entry key=3D"user" value=3D"serverx509v1"/>
+        <entry key=3D"passwordCallbackClass"
+        		value=3D"org.jboss.test.ws.jaxws.samples.wsse.ServerUsernamePass=
wordCallback"/> =

+        <entry key=3D"signaturePropFile" value=3D"etc/Server_Decrypt.prope=
rties"/>
+        <entry key=3D"signatureKeyIdentifier" value=3D"DirectReference"/>
+        <entry key=3D"signatureParts"
+        		value=3D"{Element}{http://docs.oasis-open.org/wss/2004/01/oasis-=
200401-wss-wssecurity-utility-1.0.xsd}Timestamp;{Element}{http://schemas.xm=
lsoap.org/soap/envelope/}Body"/>
+      </map>
+    </constructor-arg>
+  </bean>
+
+  <jaxws:endpoint
+    id=3D'SecureHelloWorldWS'
+    address=3D'http://@jboss.bind.address@:8080/Quickstart_bpel_secure_ser=
viceWS'
+    implementor=3D'@provider@'>
+    <jaxws:inInterceptors>
+        <ref bean=3D"UsernameTokenSign_Request"/>
+        <bean class=3D"org.apache.cxf.binding.soap.saaj.SAAJInInterceptor"=
/>
+    </jaxws:inInterceptors>
+    <jaxws:outInterceptors>
+        <ref bean=3D"UsernameTokenSign_Response"/>
+        <bean class=3D"org.apache.cxf.binding.soap.saaj.SAAJOutInterceptor=
"/>
+    </jaxws:outInterceptors>
+  </jaxws:endpoint>
+  =

+  =

+</beans>
+				]]></programlisting>
+			</informalexample>
+
+				<para>
+				This example configures the web service to use username token and digi=
tal signature
+				authentication.
+				</para>      			=

+       		</section>
+      		=

+       		<section>
+      			<title>Configuring the Client endpoint</title>
+      			=

+      			<para>
+      			When configuring client endpoints, representing web services invo=
ked by a BPEL
+      			process, the configuration is currently separated into different =
files on a per
+      			port basis - similar to the approach used by the Axis2 ODE integr=
ation.
+      			</para>
+      			=

+      			<para>
+      			The file name is of the form <filename>jbossws-cxf-{portname_loca=
l_part}.xml</filename>,
+      			where the <emphasis>portname_local_part</emphasis> represents the=
 local part of
+      			the portname of the web service being invoked. For example, if th=
e WSDL for the invoked
+      			web service is:
+     			</para>
+     			=

+			<informalexample>
+  				<programlisting role=3D"XML" ><![CDATA[
+<definitions name=3D'SecureHelloWorldWSService'
+		targetNamespace=3D'http://secure_invoke/helloworld' .... >
+    <portType name=3D'SecureHelloWorld'>
+        ...
+    </portType>
+    <service name=3D'SecureHelloWorldWSService'>
+       <port name=3D'SecureHelloWorldPort' ... >
+           ...
+       </port>
+    </service>
+</definitions>
+				]]></programlisting>
+			</informalexample>
+     			=

+     			<para>
+     			then the CXF configuration file would be <filename>jbossws-cxf-Sec=
ureHelloWorldPort.xml</filename>.
+     			</para>
+     			=

+     			<para>
+     			The CXF configuration information within this file is associated w=
ith the CXF bus. For
+     			example:
+     			</para>
+     			=

+			<informalexample>
+  				<programlisting role=3D"XML" ><![CDATA[
+<beans xmlns=3D"http://www.springframework.org/schema/beans"
+       xmlns:xsi=3D"http://www.w3.org/2001/XMLSchema-instance"
+       xmlns:cxf=3D"http://cxf.apache.org/core"
+       xmlns:wsa=3D"http://cxf.apache.org/ws/addressing"
+       xmlns:http=3D"http://cxf.apache.org/transports/http/configuration"
+       xmlns:wsrm-policy=3D"http://schemas.xmlsoap.org/ws/2005/02/rm/polic=
y"
+       xmlns:wsrm-mgr=3D"http://cxf.apache.org/ws/rm/manager"
+	   xmlns:beans=3D'http://www.springframework.org/schema/beans'
+	   xmlns:jaxws=3D'http://cxf.apache.org/jaxws'
+	   xmlns:ns1=3D'http://secure_invoke/helloworld'
+       xsi:schemaLocation=3D"
+       http://cxf.apache.org/core http://cxf.apache.org/schemas/core.xsd
+       http://cxf.apache.org/transports/http/configuration http://cxf.apac=
he.org/schemas/configuration/http-conf.xsd
+       http://schemas.xmlsoap.org/ws/2005/02/rm/policy http://schemas.xmls=
oap.org/ws/2005/02/rm/wsrm-policy.xsd
+       http://cxf.apache.org/ws/rm/manager http://cxf.apache.org/schemas/c=
onfiguration/wsrm-manager.xsd
+       http://www.springframework.org/schema/beans http://www.springframew=
ork.org/schema/beans/spring-beans.xsd
+	http://cxf.apache.org/jaxws http://cxf.apache.org/schemas/jaxws.xsd">
+
+  <bean id=3D"UsernameTokenSign_Request"
+  			class=3D"org.apache.cxf.ws.security.wss4j.WSS4JOutInterceptor" >
+    <constructor-arg>
+      <map>
+        <entry key=3D"action" value=3D"UsernameToken Timestamp Signature"/=
> =

+        <entry key=3D"passwordType" value=3D"PasswordDigest"/>
+		<entry key=3D"user" value=3D"clientx509v1"/>
+        <entry key=3D"passwordCallbackClass"
+        		value=3D"org.jboss.test.ws.jaxws.samples.wsse.ClientUsernamePass=
wordCallback"/> =

+        <entry key=3D"signaturePropFile" value=3D"etc/Client_Sign.properti=
es"/>
+        <entry key=3D"signatureKeyIdentifier" value=3D"DirectReference"/>
+        <entry key=3D"signatureParts"
+        		value=3D"{Element}{http://docs.oasis-open.org/wss/2004/01/oasis-=
200401-wss-wssecurity-utility-1.0.xsd}Timestamp;{Element}{http://schemas.xm=
lsoap.org/soap/envelope/}Body"/>
+      </map>
+    </constructor-arg>
+  </bean>
+  =

+  <bean id=3D"UsernameTokenSign_Response" =

+  			class=3D"org.apache.cxf.ws.security.wss4j.WSS4JInInterceptor" >
+    <constructor-arg>
+      <map>
+        <entry key=3D"action" value=3D"UsernameToken Timestamp Signature"/=
> =

+        <entry key=3D"passwordType" value=3D"PasswordText"/>
+	    <entry key=3D"user" value=3D"serverx509v1"/>
+        <entry key=3D"passwordCallbackClass" =

+        		value=3D"org.jboss.test.ws.jaxws.samples.wsse.ClientUsernamePass=
wordCallback"/> =

+        <entry key=3D"signaturePropFile" value=3D"etc/Client_Encrypt.prope=
rties"/>
+        <entry key=3D"signatureKeyIdentifier" value=3D"DirectReference"/>
+      </map>
+    </constructor-arg>
+  </bean>
+  =

+  <cxf:bus>
+    <cxf:outInterceptors>
+        <ref bean=3D"UsernameTokenSign_Request"/>
+        <bean class=3D"org.apache.cxf.binding.soap.saaj.SAAJOutInterceptor=
"/>
+    </cxf:outInterceptors>
+    <cxf:inInterceptors>
+        <ref bean=3D"UsernameTokenSign_Response"/>
+        <bean class=3D"org.apache.cxf.binding.soap.saaj.SAAJInInterceptor"=
/>
+    </cxf:inInterceptors>
+  </cxf:bus>
+
+</beans>
+				]]></programlisting>
+			</informalexample>
+
+				<para>
+				This example configures the web service client to use username token a=
nd digital signature
+				authentication.
+				</para>      			=

+       		</section>
+       </section>
 </chapter>


--===============5438645029765638723==--