Report Incident Example
=======================
An example based on real life use case for reporting incidents using webservice
that are transformed and send as emails to a backing system. WS-security has been
implemented. So, the user must generates a SOAP envelope containing a SOAP header
with wsse xml tag. A simple property map has been created containing user and password.
We use Apache CXF WSS4JInterceptor to get the user/password and timestamp and authenticate
the user using the WSS4J callback
You will need to compile this example first:
mvn install
Remarks:
- During the compilation phase, a unit test will be performed, this unit test simulates the
communication between a client calling the web services exposed by our camel/cxf routes. During the call,
the user "charles" is used to authenticate the web service call and the SOAP message created can be
retrieved from log file target/camel-example-reportincident-wssecurity.log
- A mock SMTP server is used during unit test
- In Eclipse, I have used the following option when starting the junit test case. This option tells
CXF that it must use log4j : -Dorg.apache.cxf.Logger=org.apache.cxf.common.logging.Log4jLogger
To run the example on Apache ServiceMix 4.x or Apache Karaf 2.x
1) launch the server
karaf.bat
For Karaf: edit the file jre.properties to add the following packages to be exported
jre-1.6=, \
com.sun.org.apache.xerces.internal.dom, \
com.sun.org.apache.xerces.internal.jaxp, \
They are required by the following bundle : org.apache.servicemix.bundles/org.apache.servicemix.bundles.saaj-impl/1.3.2_1
2) Add features required
features:addUrl mvn:org.apache.camel.karaf/apache-camel/${version}/xml/features
features:install http
features:install camel
features:install camel-cxf
features:install camel-mail
features:install camel-velocity
remark: As the camel route sends email to a SMTP server, you must configure a user/password in your favorite
SMTP Server (James by example). User = someone and password = secret
3) Deploy our example
osgi:install -s mvn:org.apache.camel/camel-example-reportincident-wssecurity
4) Verify that your service is available using in the browser the following url
http://localhost:9080/camel-example-reportincident/webservices/incident?wsdl
5) Start SOAPUI (2.x)
Create a new project called camel-example-reportincident-wssecurity
Point to the following url : http://localhost:9080/camel-example-reportincident/webservices/incident?wsdl
Open the request 1 (under camel-example-reportincident-wssecurity --> ReportIncidentBinding --> ReportIncident) and copy/paste the SOAP
message generated by the unit test
ex :
2010-07-14 09:57:54,403 [main ] INFO LoggingOutInterceptor - Outbound Message
---------------------------
ID: 1
Address: http://localhost:9080/camel-example-reportincident/webservices/incident
Encoding: UTF-8
Content-Type: text/xml
Headers: {SOAPAction=["http://reportincident.example.camel.apache.org/ReportIncident"], Accept=[*/*]}
Payload: 2010-07-14T07:57:54.387Z2010-07-14T08:02:54.387Zcharles0U5uXRYukYG5PF82gsmncH+yWEE=/Ka8O+F8cyufohiJFp8wjA==2010-07-14T07:57:54.387Z1232008-08-18ClausIbsenBlaBla bla davsclaus@apache.org0045 2962 7576
--------------------------------------
2010-07-14 09:57:54,403 [main ] DEBUG HTTPConduit - Sending POST Message with Headers to http://localhost:9080/camel-example-reportincident/webservices/incident Conduit :{http://reportincident.example.camel.apache.org}ReportIncidentEndpointPort.http-conduit
--> and the message formatted that you copy in SOAPUI
2010-07-14T09:40:29.637Z
2010-07-14T09:45:29.637Z
charles
TVzWGxNvhlixNVWol8poD9DHxl8=
WsMNSm/C4dzdPS3OhUi94Q==
2010-07-14T09:40:29.637Z
111
2010-07-14
Charles
Moulliard
Bla
Bla bla
cmoulliard@apache.org
0011 22 33 44
You can use another user: james, claus and retry.
6) Check email
Check through a POP request that a message has been published in the mailbox of someone (email address : incident@mycompany.com)
This example is documented at
http://camel.apache.org/tutorial-example-reportincident-wssecurity.html
If you hit any problems please let us know on the Camel Forums
http://camel.apache.org/discussion-forums.html
Please help us make Apache Camel better - we appreciate any feedback you may
have. Enjoy!
------------------------
The Camel riders!