Author: svkrish
Date: Tue Mar 25 06:41:45 2008
New Revision: 640810
URL: http://svn.apache.org/viewvc?rev=640810&view=rev
Log:
updates to README
Modified:
incubator/tuscany/branches/sca-java-1.2/demos/bigbank-account/README
incubator/tuscany/branches/sca-java-1.2/demos/bigbank-calculator/README
incubator/tuscany/branches/sca-java-1.2/demos/bigbank-stockquote/README
incubator/tuscany/branches/sca-java-1.2/demos/bigbank/README
Modified: incubator/tuscany/branches/sca-java-1.2/demos/bigbank-account/README
URL:
http://svn.apache.org/viewvc/incubator/tuscany/branches/sca-java-1.2/demos/bigbank-account/README?rev=640810&r1=640809&r2=640810&view=diff
==============================================================================
--- incubator/tuscany/branches/sca-java-1.2/demos/bigbank-account/README
(original)
+++ incubator/tuscany/branches/sca-java-1.2/demos/bigbank-account/README Tue
Mar 25 06:41:45 2008
@@ -1,72 +1,4 @@
-BigBank Demo
-============
-
-This application is made of 3 modules that represent the different aspects
-of a fictitious banking application. Please see bigbank.png in the
bigbank-account directory for a diagram of this demo.
-
-To run the bigbank-account demo you need to first run bigbank-calculator and
bigbank-stockquote composites. This will bring up Tuscany runtime and load the
two applications and make them available as services. Bigbank-account is
dependent on these services.
-
-This demo uses ant. This is just one way of running this demo.
-
-Start Bigbank-calculator composite
-----------------------------------
-
-Bigbank-calculator is a calculator application which handles add, subtract,
multiply and divide operations. Each of these operations is implemented in a
different language, including JavaScript, groovy, Ruby and Python.
-
-To run the bigbank-calculator composite and make it available as a service for
this demo do the following:
-
-cd bigbank-calculator
-ant compile
-ant run
-
-.. Leave the server running
-
-Note that 'ant compile' needs to be done the first time you run this demo out
of the binary distribution. No need to do 'ant compile' from there on.
-
-Start Bigbank-stockquote
-------------------------
-
-A very simple web services based stock quote application which returns random
-stock quotes on request. Please note that the stockquote service is not live
and is implemented instead to allow for this application to always run without
dependency on the availability of a webservice.
-
-cd bigbank-stockquote
-ant compile
-ant run
-
-.. Leave the server running
-
-Note that 'ant compile' needs to be done the first time you run this demo out
of the binary distribution. No need to do 'ant compile' from there on.
-
-Start Bigbank-account
----------------------
-
-Bigbank-account is entry point to this application running on Tuscany.
Bigbank-account composite calls into bigbank-stockquote and bigbank-calculator
services. Start bigbank-account in the following way:
-
-cd bigbank-account
-ant compile
-ant run
-
-.. Leave the server running
-
-Note that 'ant compile' needs to be done the first time you run this demo out
ofthe binary distribution. No need to do 'ant compile' from there on.
-
-Run the demo
--------------
-The front end of this demo application is a web app which users Json/RPC to
communicate with the backend for retrieving account information.
-
-To try the app out point you browser at:
-
-http://localhost:8080/AccountJSON.html
-
-This should display an interface with a single button that goes and retrieves
-a single set of account details exercising services across the three running
-SCA applications.
-
-If you press on getAccountReport, you'll see a response posted, but the detail
of the data will be displayed in the screen where you started bigbank-account.
-
-
-Stop the demo
--------------
-Go to each of the corresponding command line screens and hit 'enter'. This
will stop each of the applications.
+bigbank-account is part of a larger demo called bigbank.
+Please see the Readme file under bigbank to understand how bigbank-account
fits into the overall demo.
Modified:
incubator/tuscany/branches/sca-java-1.2/demos/bigbank-calculator/README
URL:
http://svn.apache.org/viewvc/incubator/tuscany/branches/sca-java-1.2/demos/bigbank-calculator/README?rev=640810&r1=640809&r2=640810&view=diff
==============================================================================
--- incubator/tuscany/branches/sca-java-1.2/demos/bigbank-calculator/README
(original)
+++ incubator/tuscany/branches/sca-java-1.2/demos/bigbank-calculator/README Tue
Mar 25 06:41:45 2008
@@ -1,3 +1,2 @@
-bigbank-calculator is part of a larger demo called bigbank-account. Please see
the Readme file under bigbank-account to understand how bigbank-calculator fits
into the overall demo.
-
-
+bigbank-calculator is part of a larger demo called bigbank.
+Please see the Readme file under bigbank to understand how bigbank-calculator
fits into the overall demo.
Modified:
incubator/tuscany/branches/sca-java-1.2/demos/bigbank-stockquote/README
URL:
http://svn.apache.org/viewvc/incubator/tuscany/branches/sca-java-1.2/demos/bigbank-stockquote/README?rev=640810&r1=640809&r2=640810&view=diff
==============================================================================
--- incubator/tuscany/branches/sca-java-1.2/demos/bigbank-stockquote/README
(original)
+++ incubator/tuscany/branches/sca-java-1.2/demos/bigbank-stockquote/README Tue
Mar 25 06:41:45 2008
@@ -1,3 +1,4 @@
-bigbank-stockquote is a part of a larger demo called bigbank-account. Please
see the Readme file under bigbank-account to understand how bigbank-stockquote
fits into the overall demo.
+bigbank-stockquote is a part of a larger demo called bigbank.
+Please see the Readme file under bigbank to understand how bigbank-stockquote
fits into the overall demo.
Modified: incubator/tuscany/branches/sca-java-1.2/demos/bigbank/README
URL:
http://svn.apache.org/viewvc/incubator/tuscany/branches/sca-java-1.2/demos/bigbank/README?rev=640810&r1=640809&r2=640810&view=diff
==============================================================================
--- incubator/tuscany/branches/sca-java-1.2/demos/bigbank/README (original)
+++ incubator/tuscany/branches/sca-java-1.2/demos/bigbank/README Tue Mar 25
06:41:45 2008
@@ -37,19 +37,68 @@
Note that 'ant compile' needs to be done the first time you run this demo out
of the binary distribution. No need to do 'ant compile' from there on.
-Start Bigbank-account
+Start Bigbank
+-------------
+The BigBank comprises of two subsystems that are built from two distinct
contributions coming from ...
+1) bigbank
+ This contains all artifacts that make up the bigbank application. This
is the application that the
+ end user interacts with
+
+2) bigbank-account
+ This contains all artifacts that deal with the account management
within the bigbank. The services
+ offered by the bigbank-account module are used by the bigbank. The end
user never gets to directly
+ interact with bigbank account
+
+Besides the bigbank-account the bigbank composite application calls into
bigbank-stockquote and
+bigbank-calculator services.
+
+Start bigbank-account in the following way:
+
+i ) Compile the bigbank-account as follows :
+
+ cd bigbank-account
+ ant compile
+
+ii) Now start the bigbank service as follows :
+
+ cd bigbank
+ ant compile
+ ant run
+
+ .. Leave the server running
+
+Note that 'ant compile' needs to be done the first time you run this demo out
ofthe binary distribution.
+No need to do 'ant compile' from there on.
+
+Bigbank and the SCA Policies
+----------------------------
+The Bigbank demo uses the Tuscany PolicyFramework to enforce security in the
following ways:
+
+Authentication
+--------------
+ The bigbank-account subsystem enforces authentication as a required
security characteristic for
+ all interactions with its CheckingAccountService. Hence the 'bigbank'
application which is a client
+ to this service authenticates itself for every interaction with the
CheckingAccountService. The interaction
+ between the bigbank and the CheckingAccountService is over the ws
binding.
+
+Integrity
+---------
+ All interactions of the bigbank application with the StockQuoteService
are guarded with message integrity.
+ These interactions use the ws binding.
+
+Authorization
+-------------
+ Within the bigbank-account subsystem the CheckingAccountService
implementation enforces authorization on
+ its operations. This is an instance of a custom policy enforcement
i.e. the CheckingAccountService
+ component's implementation has defined its own customized way of
authorizing access to its services.
+
+Demonstrated features
---------------------
-
-Bigbank-account is entry point to this application running on Tuscany.
Bigbank-account composite calls into bigbank-stockquote and bigbank-calculator
services. Start bigbank-account in the following way:
-
-cd bigbank-account
-ant compile
-ant run
-
-.. Leave the server running
-
-Note that 'ant compile' needs to be done the first time you run this demo out
ofthe binary distribution. No need to do 'ant compile' from there on.
+This demo is to illustrate the following : -
+- composition of an application using artifacts belonging to multiple
contributions (here two)
+- usage of sca policies in composite definitions with specific emphasis on
enabling security
+
Run the demo
-------------
The front end of this demo application is a web app which users Json/RPC to
communicate with the backend for retrieving account information.
@@ -62,11 +111,17 @@
a single set of account details exercising services across the three running
SCA applications.
-If you press on getAccountReport, you'll see a response posted, but the detail
of the data will be displayed in the screen where you started bigbank-account.
+If you press on getAccountReport, you'll see a response posted,
+but the detail of the data will be displayed in the console where you started
bigbank. Among other
+things you will note messages that confirm the enforecement of AUTHENTICATION,
AUTHORIZATION and
+SIGNING of messages exchaged.
+On the console where you have started the StockQuote Service you should again
be able to see messages
+that confirm the signing of messages exchanged.
Stop the demo
-------------
-Go to each of the corresponding command line screens and hit 'enter'. This
will stop each of the applications.
+Go to each of the corresponding command line screens and hit 'enter'.
+This will stop each of the applications.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
