Author: hiranya
Date: Mon Jul 22 22:10:32 2013
New Revision: 1505832
URL: http://svn.apache.org/r1505832
Log:
Applying the documentation patch for SYNAPSE-948 (sample 431).
Added:
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples/sample431.xml
Modified:
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples.xml
Modified:
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples.xml?rev=1505832&r1=1505831&r2=1505832&view=diff
==============================================================================
---
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples.xml
(original)
+++
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples.xml
Mon Jul 22 22:10:32 2013
@@ -195,6 +195,7 @@
<p>
<ul>
<li><a href="samples/sample430.html">Sample 430:
Callout mediator for synchronous web service invocations</a></li>
+ <li><a href="samples/sample431.html">Sample 431:
Callout Mediator with WS-Security for Outgoing Messages</a></li>
</ul>
</p>
<h4>URL Rewrite Mediator</h4>
Added:
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples/sample431.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples/sample431.xml?rev=1505832&view=auto
==============================================================================
---
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples/sample431.xml
(added)
+++
synapse/trunk/java/modules/documentation/src/site/xdoc/userguide/samples/sample431.xml
Mon Jul 22 22:10:32 2013
@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!--
+ ~ Licensed to the Apache Software Foundation (ASF) under one
+ ~ or more contributor license agreements. See the NOTICE file
+ ~ distributed with this work for additional information
+ ~ regarding copyright ownership. The ASF licenses this file
+ ~ to you under the Apache License, Version 2.0 (the
+ ~ "License"); you may not use this file except in compliance
+ ~ with the License. You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing,
+ ~ software distributed under the License is distributed on an
+ ~ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ ~ KIND, either express or implied. See the License for the
+ ~ specific language governing permissions and limitations
+ ~ under the License.
+ -->
+
+<document>
+ <properties>
+ <title>Apache Synapse - Sample 431</title>
+ </properties>
+ <body>
+ <section name="Sample 431: Callout Mediator with WS-Security for
Outgoing Messages">
+ <div class="xmlConf"><definitions
xmlns="http://ws.apache.org/ns/synapse">
+
+ <localEntry key="sec_policy"
src="file:repository/conf/sample/resources/policy/policy_3.xml"/>
+
+ <sequence name="main">
+ <callout
serviceURL="http://localhost:9000/services/SecureStockQuoteService";
+ action="urn:getQuote">
+ <source xmlns:s11="http://schemas.xmlsoap.org/soap/envelope/";
+ xmlns:s12="http://www.w3.org/2003/05/soap-envelope";
+ xpath="s11:Body/child::*[fn:position()=1] |
s12:Body/child::*[fn:position()=1]"/>
+ <target xmlns:s11="http://schemas.xmlsoap.org/soap/envelope/";
+ xmlns:s12="http://www.w3.org/2003/05/soap-envelope";
+ xpath="s11:Body/child::*[fn:position()=1] |
s12:Body/child::*[fn:position()=1]"/>
+ <enableSec policy="sec_policy"/>
+ </callout>
+ <property name="RESPONSE" value="true"/>
+ <header name="To" action="remove"/>
+ <send/>
+ <drop/>
+ </sequence>
+
+</definitions></div>
+ <subsection name="Objective">
+ <p>
+ Demonstrate the usage of the Callout mediator for making
synchronous (blocking)
+ Web service calls to invoke secured services during
mediation.
+ </p>
+ </subsection>
+ <subsection name="Pre-requisites">
+ <p>
+ <ul>
+ <li>
+ Download and install the Java Cryptography
Extension (JCE) unlimited
+ strength policy files for your JDK
+ </li>
+ <li>
+ Deploy the SecureStockQuoteService in the sample
Axis2 server and start Axis2
+ </li>
+ <li>
+ Start Synapse using the configuration numbered 431
(repository/conf/sample/synapse_sample_431.xml)
+ <div class="command">
+ Unix/Linux: sh synapse.sh -sample 431<br/>
+ Windows: synapse.bat -sample 431
+ </div>
+ </li>
+ </ul>
+ </p>
+ </subsection>
+ <subsection name="Executing the Client">
+ <p>
+ In this sample, the Callout mediator does the service
invocation to the Secured service
+ SecureStockQuoteService by encrypting the client request
according to the defined policy.
+ And then received encrypted message is decrypted and after
removing the wsse:Security header,
+ the message is sent back to the client using the send
mediator.
+
+ Callout Mediator is configured to enable WS-Security as
per the policy specified by 'policy_3.xml'.
+ </p>
+ <p>
+ Invoke the client as follows.
+ </p>
+ <div class="command">ant stockquote
-Dtrpurl=http://localhost:8280/</div>
+ </subsection>
+ </section>
+ <p><a href="../samples.html">Back to Catalog</a></p>
+ </body>
+</document>
\ No newline at end of file
