You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cxf.apache.org by ow...@apache.org on 2012/06/06 21:58:45 UTC
svn commit: r1347084 - in /cxf/fediz/trunk: BUILDING.txt README.txt
examples/simpleWebapp/README.txt examples/simpleWebapp/pom.xml
examples/wsclientWebapp/README.txt examples/wsclientWebapp/webapp/pom.xml
release_notes.txt
Author: owulff
Date: Wed Jun 6 19:58:45 2012
New Revision: 1347084
URL: http://svn.apache.org/viewvc?rev=1347084&view=rev
Log:
added readme, building, release notes and removed fediz-tomcat dependencies in examples
Added:
cxf/fediz/trunk/BUILDING.txt
cxf/fediz/trunk/README.txt
cxf/fediz/trunk/release_notes.txt
Modified:
cxf/fediz/trunk/examples/simpleWebapp/README.txt
cxf/fediz/trunk/examples/simpleWebapp/pom.xml
cxf/fediz/trunk/examples/wsclientWebapp/README.txt
cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml
Added: cxf/fediz/trunk/BUILDING.txt
URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/BUILDING.txt?rev=1347084&view=auto
==============================================================================
--- cxf/fediz/trunk/BUILDING.txt (added)
+++ cxf/fediz/trunk/BUILDING.txt Wed Jun 6 19:58:45 2012
@@ -0,0 +1,53 @@
+Building Apache CXF Fediz
+=========================
+
+Initial Setup
+-------------
+
+1) Install J2SE 6.0 SDK, which can be downloaded from
+ http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html
+
+2) Make sure that your JAVA_HOME environment variable is set to the newly installed
+ JDK location, and that your PATH includes %JAVA_HOME%\bin (windows) or
+ $JAVA_HOME$/bin (unix).
+
+3) Install Maven 2.2.1 or newer, which can be downloaded from
+ http://maven.apache.org/download.html. Make sure that your PATH includes
+ the MVN_HOME/bin directory.
+
+
+Building
+--------
+
+1) Change to the top level directory of Apache CXF Fediz source distribution.
+2) Run
+ $> mvn.
+ This will compile Apache CXF Fediz and run all of the tests in the Apache CXF Fediz source
+ distribution. Alternatively, you can run
+ $> mvn -Pfastinstall.
+ This will compile Apache CXF Fediz without running the tests and takes less
+ time to build.
+ Depending on the load of remote Maven repositories, you may have
+ to run "mvn" several times utill the required dependencies are
+ all located in your local maven repository. It usually takes some time for
+ maven to download required dependencies in the first build.
+
+
+Source Directory structure
+--------------------------
+
+ + plugins contains the sources of the federation plugin
+ + core the core module contains the majority of functionality which is Servlet container agnostic
+ + tomcat the tomcat module is the bridge of the core to the tomcat specific security engine
+
+ + services contains the sources of the Identity Provider
+ + sts the sts module contains the configured CXF STS which supports the usecases for Federation
+ + idp the idp module is the bridge of the STS to a WS-Trust/SOAP unaware browser
+
+ + examples
+ + simpleWebapp this example shows how to protect a simple web application using the fediz plugin
+ + wsclientWebapp this example shows how a protected web application calls a web service protected by the STS
+ + webapp contains the web application
+ + webservice contains the web services implementation
+
+
Added: cxf/fediz/trunk/README.txt
URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/README.txt?rev=1347084&view=auto
==============================================================================
--- cxf/fediz/trunk/README.txt (added)
+++ cxf/fediz/trunk/README.txt Wed Jun 6 19:58:45 2012
@@ -0,0 +1,76 @@
+Welcome to Apache CXF Fediz!
+============================
+Fediz helps you to secure your web applications and delegates security enforcement
+to the underlying application server. With Fediz, authentication is externalized
+from your web application to an identity provider installed as a dedicated server component.
+The supported standard is WS-Federation 1.2 Passive Requestor Profile.
+Fediz supports Claims Based Access Control beyond Role Based Access Control (RBAC).
+
+Fediz includes the following feature set:
+
+ WS-Federation 1.1/1.2
+ SAML 1.1/2.0 Tokens
+ Custom token support
+ Publish WS-Federation Metadata document
+ Role information encoded as AttributeStatement in SAML 1.1/2.0 tokens
+ Claims information provided by FederationPrincipal interface
+
+
+Export Notice
+============================
+This distribution includes cryptographic software. The country in
+which you currently reside may have restrictions on the import,
+possession, use, and/or re-export to another country, of
+encryption software. BEFORE using any encryption software, please
+check your country's laws, regulations and policies concerning the
+import, possession, or use, and re-export of encryption software, to
+see if this is permitted. See <http://www.wassenaar.org/> for more
+information.
+
+The U.S. Government Department of Commerce, Bureau of Industry and
+Security (BIS), has classified this software as Export Commodity
+Control Number (ECCN) 5D002.C.1, which includes information security
+software using or performing cryptographic functions with asymmetric
+algorithms. The form and manner of this Apache Software Foundation
+distribution makes it eligible for export under the License Exception
+ENC Technology Software Unrestricted (TSU) exception (see the BIS
+Export Administration Regulations, Section 740.13) for both object
+code and source code.
+
+The following provides more details on the included cryptographic
+software:
+ http://xml.apache.org/security/
+ http://www.bouncycastle.org/
+ http://ws.apache.org/wss4j/
+
+
+
+Getting Started
+===============
+
+For an Apache CXF Fediz source distribution, please read BUILDING.txt for
+instructions on building Apache CXF Fediz.
+
+For an Apache CXF Fediz binary distribution, please read release_notes.txt
+for installation instructions and list of supported and unsupported
+features.
+
+Alternatively, you can also find out how to get started here:
+http://cxf.apache.org/fediz.html
+
+If you need more help try talking to us on our mailing lists:
+http://cxf.apache.org/mailing-lists.html
+
+If you find any issues with Fediz, please submit reports with JIRA here:
+https://issues.apache.org/jira/browse/FEDIZ
+
+We welcome contributions, and encourage you to get involved in the CXF
+community. If you'd like to learn more about how you can contribute, please
+see:
+http://cxf.apache.org/getting-involved.html
+
+Thank you for using CXF Fediz!
+
+The Apache CXF Team
+http://cxf.apache.org/
+
Modified: cxf/fediz/trunk/examples/simpleWebapp/README.txt
URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/simpleWebapp/README.txt?rev=1347084&r1=1347083&r2=1347084&view=diff
==============================================================================
--- cxf/fediz/trunk/examples/simpleWebapp/README.txt (original)
+++ cxf/fediz/trunk/examples/simpleWebapp/README.txt Wed Jun 6 19:58:45 2012
@@ -46,6 +46,13 @@ Prerequisite
------------
Please review the README in the samples main directory before continuing.
+Copy the Fediz Configuration file into the directory 'conf' of the Tomcat installation. The configuration file
+is located in src/main/config/fediz_config.xml of this example.
+
+This configuration references the java keystore 'conf/stsstore.jks' which contains the certificate to validate
+a SAML token issued by the IDP/STS. This keystore is located in webapps/fedizidpsts/WEB-INF/classes/stsstore.jks (deployed)
+or in services/sts/src/main/resources/stsstore.jks (source)
+
Building the demo using Maven
-----------------------------
Modified: cxf/fediz/trunk/examples/simpleWebapp/pom.xml
URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/simpleWebapp/pom.xml?rev=1347084&r1=1347083&r2=1347084&view=diff
==============================================================================
--- cxf/fediz/trunk/examples/simpleWebapp/pom.xml (original)
+++ cxf/fediz/trunk/examples/simpleWebapp/pom.xml Wed Jun 6 19:58:45 2012
@@ -51,6 +51,7 @@
<version>2.5</version>
<scope>provided</scope>
</dependency>
+ <!-- Required to cast Principal to FederationPrincipal -->
<dependency>
<groupId>org.apache.cxf.fediz</groupId>
<artifactId>fediz-core</artifactId>
@@ -58,12 +59,6 @@
<scope>provided</scope>
</dependency>
<dependency>
- <groupId>org.apache.cxf.fediz</groupId>
- <artifactId>fediz-tomcat</artifactId>
- <version>${project.version}</version>
- <scope>provided</scope>
- </dependency>
- <dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.0.1</version>
Modified: cxf/fediz/trunk/examples/wsclientWebapp/README.txt
URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/wsclientWebapp/README.txt?rev=1347084&r1=1347083&r2=1347084&view=diff
==============================================================================
--- cxf/fediz/trunk/examples/wsclientWebapp/README.txt (original)
+++ cxf/fediz/trunk/examples/wsclientWebapp/README.txt Wed Jun 6 19:58:45 2012
@@ -70,6 +70,13 @@ Prerequisite
Please review the README in the samples main directory before continuing.
It's recommended to run the demo simpleWebapp first as this is an extended demo.
+Copy the Fediz Configuration file into the directory 'conf' of the Tomcat installation. The configuration file
+is located in src/main/config/fediz_config.xml of this example.
+
+This configuration references the java keystore 'conf/stsstore.jks' which contains the certificate to validate
+a SAML token issued by the IDP/STS. This keystore is located in webapps/fedizidpsts/WEB-INF/classes/stsstore.jks (deployed)
+or in services/sts/src/main/resources/stsstore.jks (source)
+
Building the demo using Maven
-----------------------------
Modified: cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml
URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml?rev=1347084&r1=1347083&r2=1347084&view=diff
==============================================================================
--- cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml (original)
+++ cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml Wed Jun 6 19:58:45 2012
@@ -52,6 +52,7 @@
<version>${tomcat.version}</version>
<scope>provided</scope>
</dependency>
+ <!-- Required to cast Principal to FederationPrincipal -->
<dependency>
<groupId>org.apache.cxf.fediz</groupId>
<artifactId>fediz-core</artifactId>
@@ -59,12 +60,6 @@
<scope>provided</scope>
</dependency>
<dependency>
- <groupId>org.apache.cxf.fediz</groupId>
- <artifactId>fediz-tomcat</artifactId>
- <version>${project.version}</version>
- <scope>provided</scope>
- </dependency>
- <dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.0.1</version>
Added: cxf/fediz/trunk/release_notes.txt
URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/release_notes.txt?rev=1347084&view=auto
==============================================================================
--- cxf/fediz/trunk/release_notes.txt (added)
+++ cxf/fediz/trunk/release_notes.txt Wed Jun 6 19:58:45 2012
@@ -0,0 +1,58 @@
+Apache CXF Fediz 1.0.0 Release Notes
+
+1. Overview
+
+The 1.0.x versions of Apache CXF Fediz is the first version of Fediz that
+provides the following features:
+
+* WS-Federation 1.0/1.1/1.2
+* SAML 1.1/2.0 Tokens
+* Custom token support
+* Publish WS-Federation Metadata document
+* Role information encoded as AttributeStatement in SAML 1.1/2.0 tokens
+* Claims information provided by FederationPrincipal interface
+
+
+2. Installation Prerequisites
+
+Before installing Apache CXF Fediz, make sure the following products,
+with the specified versions, are installed on your system:
+
+ * Java 6 Development Kit
+ * Apache Maven 2.2.1 or 3.x to build the samples
+
+
+3. Building the Samples
+
+Building the samples included in the binary distribution is easy. Change to
+the examples directory and follow the build instructions in the README.txt file
+included with each sample.
+
+
+4. Reporting Problems
+
+If you have any problems or want to send feedback of any kind, please e-mail the
+CXF dev list, dev@cxf.apache.org. You can also file issues in JIRA at:
+
+http://issues.apache.org/jira/browse/FEDIZ
+
+
+5. Migration notes:
+
+N.A.
+
+
+6. Specific issues, features, and improvements fixed in this version
+
+** Bug
+
+** Improvement
+
+** New Feature
+
+** Task
+
+** Test
+
+
+
RE: svn commit: r1347084 - in /cxf/fediz/trunk: BUILDING.txt
README.txt examples/simpleWebapp/README.txt examples/simpleWebapp/pom.xml
examples/wsclientWebapp/README.txt examples/wsclientWebapp/webapp/pom.xml
release_notes.txt
Posted by Oliver Wulff <ow...@talend.com>.
>>>
Oli, in BUILDING.txt and release-notes.txt you're saying that the person
needs Java 6 to build -- but won't Java 7 also work?
>>>
Haven't tested it yet.
>>>
Also, in release_notes.txt, "Reporting Problems", you refer them to the
dev list if they have any problems or questions--can we refer them to
the User's list instead? Users shouldn't have to subscribe to the dev
list to discuss any problems/questions they incur.
>>>
Will update that.
Thanks
------
Oliver Wulff
Blog: http://owulff.blogspot.com
Solution Architect
http://coders.talend.com
Talend Application Integration Division http://www.talend.com
________________________________________
From: Glen Mazza [gmazza@talend.com]
Sent: 06 June 2012 22:39
To: dev@cxf.apache.org
Subject: Re: svn commit: r1347084 - in /cxf/fediz/trunk: BUILDING.txt README.txt examples/simpleWebapp/README.txt examples/simpleWebapp/pom.xml examples/wsclientWebapp/README.txt examples/wsclientWebapp/webapp/pom.xml release_notes.txt
Oli, in BUILDING.txt and release-notes.txt you're saying that the person
needs Java 6 to build -- but won't Java 7 also work? I wouldn't want to
annoy users already on Java 7 to think they have to download the older JDK.
Also, in release_notes.txt, "Reporting Problems", you refer them to the
dev list if they have any problems or questions--can we refer them to
the User's list instead? Users shouldn't have to subscribe to the dev
list to discuss any problems/questions they incur.
Thanks,
Glen
On 06/06/2012 03:58 PM, owulff@apache.org wrote:
> Author: owulff
> Date: Wed Jun 6 19:58:45 2012
> New Revision: 1347084
>
> URL: http://svn.apache.org/viewvc?rev=1347084&view=rev
> Log:
> added readme, building, release notes and removed fediz-tomcat dependencies in examples
>
> Added:
> cxf/fediz/trunk/BUILDING.txt
> cxf/fediz/trunk/README.txt
> cxf/fediz/trunk/release_notes.txt
> Modified:
> cxf/fediz/trunk/examples/simpleWebapp/README.txt
> cxf/fediz/trunk/examples/simpleWebapp/pom.xml
> cxf/fediz/trunk/examples/wsclientWebapp/README.txt
> cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml
>
> Added: cxf/fediz/trunk/BUILDING.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/BUILDING.txt?rev=1347084&view=auto
> ==============================================================================
> --- cxf/fediz/trunk/BUILDING.txt (added)
> +++ cxf/fediz/trunk/BUILDING.txt Wed Jun 6 19:58:45 2012
> @@ -0,0 +1,53 @@
> +Building Apache CXF Fediz
> +=========================
> +
> +Initial Setup
> +-------------
> +
> +1) Install J2SE 6.0 SDK, which can be downloaded from
> + http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html
> +
> +2) Make sure that your JAVA_HOME environment variable is set to the newly installed
> + JDK location, and that your PATH includes %JAVA_HOME%\bin (windows) or
> + $JAVA_HOME$/bin (unix).
> +
> +3) Install Maven 2.2.1 or newer, which can be downloaded from
> + http://maven.apache.org/download.html. Make sure that your PATH includes
> + the MVN_HOME/bin directory.
> +
> +
> +Building
> +--------
> +
> +1) Change to the top level directory of Apache CXF Fediz source distribution.
> +2) Run
> + $> mvn.
> + This will compile Apache CXF Fediz and run all of the tests in the Apache CXF Fediz source
> + distribution. Alternatively, you can run
> + $> mvn -Pfastinstall.
> + This will compile Apache CXF Fediz without running the tests and takes less
> + time to build.
> + Depending on the load of remote Maven repositories, you may have
> + to run "mvn" several times utill the required dependencies are
> + all located in your local maven repository. It usually takes some time for
> + maven to download required dependencies in the first build.
> +
> +
> +Source Directory structure
> +--------------------------
> +
> + + plugins contains the sources of the federation plugin
> + + core the core module contains the majority of functionality which is Servlet container agnostic
> + + tomcat the tomcat module is the bridge of the core to the tomcat specific security engine
> +
> + + services contains the sources of the Identity Provider
> + + sts the sts module contains the configured CXF STS which supports the usecases for Federation
> + + idp the idp module is the bridge of the STS to a WS-Trust/SOAP unaware browser
> +
> + + examples
> + + simpleWebapp this example shows how to protect a simple web application using the fediz plugin
> + + wsclientWebapp this example shows how a protected web application calls a web service protected by the STS
> + + webapp contains the web application
> + + webservice contains the web services implementation
> +
> +
>
> Added: cxf/fediz/trunk/README.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/README.txt?rev=1347084&view=auto
> ==============================================================================
> --- cxf/fediz/trunk/README.txt (added)
> +++ cxf/fediz/trunk/README.txt Wed Jun 6 19:58:45 2012
> @@ -0,0 +1,76 @@
> +Welcome to Apache CXF Fediz!
> +============================
> +Fediz helps you to secure your web applications and delegates security enforcement
> +to the underlying application server. With Fediz, authentication is externalized
> +from your web application to an identity provider installed as a dedicated server component.
> +The supported standard is WS-Federation 1.2 Passive Requestor Profile.
> +Fediz supports Claims Based Access Control beyond Role Based Access Control (RBAC).
> +
> +Fediz includes the following feature set:
> +
> + WS-Federation 1.1/1.2
> + SAML 1.1/2.0 Tokens
> + Custom token support
> + Publish WS-Federation Metadata document
> + Role information encoded as AttributeStatement in SAML 1.1/2.0 tokens
> + Claims information provided by FederationPrincipal interface
> +
> +
> +Export Notice
> +============================
> +This distribution includes cryptographic software. The country in
> +which you currently reside may have restrictions on the import,
> +possession, use, and/or re-export to another country, of
> +encryption software. BEFORE using any encryption software, please
> +check your country's laws, regulations and policies concerning the
> +import, possession, or use, and re-export of encryption software, to
> +see if this is permitted. See<http://www.wassenaar.org/> for more
> +information.
> +
> +The U.S. Government Department of Commerce, Bureau of Industry and
> +Security (BIS), has classified this software as Export Commodity
> +Control Number (ECCN) 5D002.C.1, which includes information security
> +software using or performing cryptographic functions with asymmetric
> +algorithms. The form and manner of this Apache Software Foundation
> +distribution makes it eligible for export under the License Exception
> +ENC Technology Software Unrestricted (TSU) exception (see the BIS
> +Export Administration Regulations, Section 740.13) for both object
> +code and source code.
> +
> +The following provides more details on the included cryptographic
> +software:
> + http://xml.apache.org/security/
> + http://www.bouncycastle.org/
> + http://ws.apache.org/wss4j/
> +
> +
> +
> +Getting Started
> +===============
> +
> +For an Apache CXF Fediz source distribution, please read BUILDING.txt for
> +instructions on building Apache CXF Fediz.
> +
> +For an Apache CXF Fediz binary distribution, please read release_notes.txt
> +for installation instructions and list of supported and unsupported
> +features.
> +
> +Alternatively, you can also find out how to get started here:
> +http://cxf.apache.org/fediz.html
> +
> +If you need more help try talking to us on our mailing lists:
> +http://cxf.apache.org/mailing-lists.html
> +
> +If you find any issues with Fediz, please submit reports with JIRA here:
> +https://issues.apache.org/jira/browse/FEDIZ
> +
> +We welcome contributions, and encourage you to get involved in the CXF
> +community. If you'd like to learn more about how you can contribute, please
> +see:
> +http://cxf.apache.org/getting-involved.html
> +
> +Thank you for using CXF Fediz!
> +
> +The Apache CXF Team
> +http://cxf.apache.org/
> +
>
> Modified: cxf/fediz/trunk/examples/simpleWebapp/README.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/simpleWebapp/README.txt?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/simpleWebapp/README.txt (original)
> +++ cxf/fediz/trunk/examples/simpleWebapp/README.txt Wed Jun 6 19:58:45 2012
> @@ -46,6 +46,13 @@ Prerequisite
> ------------
> Please review the README in the samples main directory before continuing.
>
> +Copy the Fediz Configuration file into the directory 'conf' of the Tomcat installation. The configuration file
> +is located in src/main/config/fediz_config.xml of this example.
> +
> +This configuration references the java keystore 'conf/stsstore.jks' which contains the certificate to validate
> +a SAML token issued by the IDP/STS. This keystore is located in webapps/fedizidpsts/WEB-INF/classes/stsstore.jks (deployed)
> +or in services/sts/src/main/resources/stsstore.jks (source)
> +
>
> Building the demo using Maven
> -----------------------------
>
> Modified: cxf/fediz/trunk/examples/simpleWebapp/pom.xml
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/simpleWebapp/pom.xml?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/simpleWebapp/pom.xml (original)
> +++ cxf/fediz/trunk/examples/simpleWebapp/pom.xml Wed Jun 6 19:58:45 2012
> @@ -51,6 +51,7 @@
> <version>2.5</version>
> <scope>provided</scope>
> </dependency>
> +<!-- Required to cast Principal to FederationPrincipal -->
> <dependency>
> <groupId>org.apache.cxf.fediz</groupId>
> <artifactId>fediz-core</artifactId>
> @@ -58,12 +59,6 @@
> <scope>provided</scope>
> </dependency>
> <dependency>
> -<groupId>org.apache.cxf.fediz</groupId>
> -<artifactId>fediz-tomcat</artifactId>
> -<version>${project.version}</version>
> -<scope>provided</scope>
> -</dependency>
> -<dependency>
> <groupId>org.apache.commons</groupId>
> <artifactId>commons-lang3</artifactId>
> <version>3.0.1</version>
>
> Modified: cxf/fediz/trunk/examples/wsclientWebapp/README.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/wsclientWebapp/README.txt?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/wsclientWebapp/README.txt (original)
> +++ cxf/fediz/trunk/examples/wsclientWebapp/README.txt Wed Jun 6 19:58:45 2012
> @@ -70,6 +70,13 @@ Prerequisite
> Please review the README in the samples main directory before continuing.
> It's recommended to run the demo simpleWebapp first as this is an extended demo.
>
> +Copy the Fediz Configuration file into the directory 'conf' of the Tomcat installation. The configuration file
> +is located in src/main/config/fediz_config.xml of this example.
> +
> +This configuration references the java keystore 'conf/stsstore.jks' which contains the certificate to validate
> +a SAML token issued by the IDP/STS. This keystore is located in webapps/fedizidpsts/WEB-INF/classes/stsstore.jks (deployed)
> +or in services/sts/src/main/resources/stsstore.jks (source)
> +
>
> Building the demo using Maven
> -----------------------------
>
> Modified: cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml (original)
> +++ cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml Wed Jun 6 19:58:45 2012
> @@ -52,6 +52,7 @@
> <version>${tomcat.version}</version>
> <scope>provided</scope>
> </dependency>
> + <!-- Required to cast Principal to FederationPrincipal -->
> <dependency>
> <groupId>org.apache.cxf.fediz</groupId>
> <artifactId>fediz-core</artifactId>
> @@ -59,12 +60,6 @@
> <scope>provided</scope>
> </dependency>
> <dependency>
> - <groupId>org.apache.cxf.fediz</groupId>
> - <artifactId>fediz-tomcat</artifactId>
> - <version>${project.version}</version>
> - <scope>provided</scope>
> - </dependency>
> - <dependency>
> <groupId>org.apache.commons</groupId>
> <artifactId>commons-lang3</artifactId>
> <version>3.0.1</version>
>
> Added: cxf/fediz/trunk/release_notes.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/release_notes.txt?rev=1347084&view=auto
> ==============================================================================
> --- cxf/fediz/trunk/release_notes.txt (added)
> +++ cxf/fediz/trunk/release_notes.txt Wed Jun 6 19:58:45 2012
> @@ -0,0 +1,58 @@
> +Apache CXF Fediz 1.0.0 Release Notes
> +
> +1. Overview
> +
> +The 1.0.x versions of Apache CXF Fediz is the first version of Fediz that
> +provides the following features:
> +
> +* WS-Federation 1.0/1.1/1.2
> +* SAML 1.1/2.0 Tokens
> +* Custom token support
> +* Publish WS-Federation Metadata document
> +* Role information encoded as AttributeStatement in SAML 1.1/2.0 tokens
> +* Claims information provided by FederationPrincipal interface
> +
> +
> +2. Installation Prerequisites
> +
> +Before installing Apache CXF Fediz, make sure the following products,
> +with the specified versions, are installed on your system:
> +
> + * Java 6 Development Kit
> + * Apache Maven 2.2.1 or 3.x to build the samples
> +
> +
> +3. Building the Samples
> +
> +Building the samples included in the binary distribution is easy. Change to
> +the examples directory and follow the build instructions in the README.txt file
> +included with each sample.
> +
> +
> +4. Reporting Problems
> +
> +If you have any problems or want to send feedback of any kind, please e-mail the
> +CXF dev list, dev@cxf.apache.org. You can also file issues in JIRA at:
> +
> +http://issues.apache.org/jira/browse/FEDIZ
> +
> +
> +5. Migration notes:
> +
> +N.A.
> +
> +
> +6. Specific issues, features, and improvements fixed in this version
> +
> +** Bug
> +
> +** Improvement
> +
> +** New Feature
> +
> +** Task
> +
> +** Test
> +
> +
> +
>
>
--
Glen Mazza
Talend Community Coders
coders.talend.com
blog: www.jroller.com/gmazza
Re: svn commit: r1347084 - in /cxf/fediz/trunk: BUILDING.txt README.txt
examples/simpleWebapp/README.txt examples/simpleWebapp/pom.xml examples/wsclientWebapp/README.txt
examples/wsclientWebapp/webapp/pom.xml release_notes.txt
Posted by Glen Mazza <gm...@talend.com>.
Oli, in BUILDING.txt and release-notes.txt you're saying that the person
needs Java 6 to build -- but won't Java 7 also work? I wouldn't want to
annoy users already on Java 7 to think they have to download the older JDK.
Also, in release_notes.txt, "Reporting Problems", you refer them to the
dev list if they have any problems or questions--can we refer them to
the User's list instead? Users shouldn't have to subscribe to the dev
list to discuss any problems/questions they incur.
Thanks,
Glen
On 06/06/2012 03:58 PM, owulff@apache.org wrote:
> Author: owulff
> Date: Wed Jun 6 19:58:45 2012
> New Revision: 1347084
>
> URL: http://svn.apache.org/viewvc?rev=1347084&view=rev
> Log:
> added readme, building, release notes and removed fediz-tomcat dependencies in examples
>
> Added:
> cxf/fediz/trunk/BUILDING.txt
> cxf/fediz/trunk/README.txt
> cxf/fediz/trunk/release_notes.txt
> Modified:
> cxf/fediz/trunk/examples/simpleWebapp/README.txt
> cxf/fediz/trunk/examples/simpleWebapp/pom.xml
> cxf/fediz/trunk/examples/wsclientWebapp/README.txt
> cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml
>
> Added: cxf/fediz/trunk/BUILDING.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/BUILDING.txt?rev=1347084&view=auto
> ==============================================================================
> --- cxf/fediz/trunk/BUILDING.txt (added)
> +++ cxf/fediz/trunk/BUILDING.txt Wed Jun 6 19:58:45 2012
> @@ -0,0 +1,53 @@
> +Building Apache CXF Fediz
> +=========================
> +
> +Initial Setup
> +-------------
> +
> +1) Install J2SE 6.0 SDK, which can be downloaded from
> + http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html
> +
> +2) Make sure that your JAVA_HOME environment variable is set to the newly installed
> + JDK location, and that your PATH includes %JAVA_HOME%\bin (windows) or
> + $JAVA_HOME$/bin (unix).
> +
> +3) Install Maven 2.2.1 or newer, which can be downloaded from
> + http://maven.apache.org/download.html. Make sure that your PATH includes
> + the MVN_HOME/bin directory.
> +
> +
> +Building
> +--------
> +
> +1) Change to the top level directory of Apache CXF Fediz source distribution.
> +2) Run
> + $> mvn.
> + This will compile Apache CXF Fediz and run all of the tests in the Apache CXF Fediz source
> + distribution. Alternatively, you can run
> + $> mvn -Pfastinstall.
> + This will compile Apache CXF Fediz without running the tests and takes less
> + time to build.
> + Depending on the load of remote Maven repositories, you may have
> + to run "mvn" several times utill the required dependencies are
> + all located in your local maven repository. It usually takes some time for
> + maven to download required dependencies in the first build.
> +
> +
> +Source Directory structure
> +--------------------------
> +
> + + plugins contains the sources of the federation plugin
> + + core the core module contains the majority of functionality which is Servlet container agnostic
> + + tomcat the tomcat module is the bridge of the core to the tomcat specific security engine
> +
> + + services contains the sources of the Identity Provider
> + + sts the sts module contains the configured CXF STS which supports the usecases for Federation
> + + idp the idp module is the bridge of the STS to a WS-Trust/SOAP unaware browser
> +
> + + examples
> + + simpleWebapp this example shows how to protect a simple web application using the fediz plugin
> + + wsclientWebapp this example shows how a protected web application calls a web service protected by the STS
> + + webapp contains the web application
> + + webservice contains the web services implementation
> +
> +
>
> Added: cxf/fediz/trunk/README.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/README.txt?rev=1347084&view=auto
> ==============================================================================
> --- cxf/fediz/trunk/README.txt (added)
> +++ cxf/fediz/trunk/README.txt Wed Jun 6 19:58:45 2012
> @@ -0,0 +1,76 @@
> +Welcome to Apache CXF Fediz!
> +============================
> +Fediz helps you to secure your web applications and delegates security enforcement
> +to the underlying application server. With Fediz, authentication is externalized
> +from your web application to an identity provider installed as a dedicated server component.
> +The supported standard is WS-Federation 1.2 Passive Requestor Profile.
> +Fediz supports Claims Based Access Control beyond Role Based Access Control (RBAC).
> +
> +Fediz includes the following feature set:
> +
> + WS-Federation 1.1/1.2
> + SAML 1.1/2.0 Tokens
> + Custom token support
> + Publish WS-Federation Metadata document
> + Role information encoded as AttributeStatement in SAML 1.1/2.0 tokens
> + Claims information provided by FederationPrincipal interface
> +
> +
> +Export Notice
> +============================
> +This distribution includes cryptographic software. The country in
> +which you currently reside may have restrictions on the import,
> +possession, use, and/or re-export to another country, of
> +encryption software. BEFORE using any encryption software, please
> +check your country's laws, regulations and policies concerning the
> +import, possession, or use, and re-export of encryption software, to
> +see if this is permitted. See<http://www.wassenaar.org/> for more
> +information.
> +
> +The U.S. Government Department of Commerce, Bureau of Industry and
> +Security (BIS), has classified this software as Export Commodity
> +Control Number (ECCN) 5D002.C.1, which includes information security
> +software using or performing cryptographic functions with asymmetric
> +algorithms. The form and manner of this Apache Software Foundation
> +distribution makes it eligible for export under the License Exception
> +ENC Technology Software Unrestricted (TSU) exception (see the BIS
> +Export Administration Regulations, Section 740.13) for both object
> +code and source code.
> +
> +The following provides more details on the included cryptographic
> +software:
> + http://xml.apache.org/security/
> + http://www.bouncycastle.org/
> + http://ws.apache.org/wss4j/
> +
> +
> +
> +Getting Started
> +===============
> +
> +For an Apache CXF Fediz source distribution, please read BUILDING.txt for
> +instructions on building Apache CXF Fediz.
> +
> +For an Apache CXF Fediz binary distribution, please read release_notes.txt
> +for installation instructions and list of supported and unsupported
> +features.
> +
> +Alternatively, you can also find out how to get started here:
> +http://cxf.apache.org/fediz.html
> +
> +If you need more help try talking to us on our mailing lists:
> +http://cxf.apache.org/mailing-lists.html
> +
> +If you find any issues with Fediz, please submit reports with JIRA here:
> +https://issues.apache.org/jira/browse/FEDIZ
> +
> +We welcome contributions, and encourage you to get involved in the CXF
> +community. If you'd like to learn more about how you can contribute, please
> +see:
> +http://cxf.apache.org/getting-involved.html
> +
> +Thank you for using CXF Fediz!
> +
> +The Apache CXF Team
> +http://cxf.apache.org/
> +
>
> Modified: cxf/fediz/trunk/examples/simpleWebapp/README.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/simpleWebapp/README.txt?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/simpleWebapp/README.txt (original)
> +++ cxf/fediz/trunk/examples/simpleWebapp/README.txt Wed Jun 6 19:58:45 2012
> @@ -46,6 +46,13 @@ Prerequisite
> ------------
> Please review the README in the samples main directory before continuing.
>
> +Copy the Fediz Configuration file into the directory 'conf' of the Tomcat installation. The configuration file
> +is located in src/main/config/fediz_config.xml of this example.
> +
> +This configuration references the java keystore 'conf/stsstore.jks' which contains the certificate to validate
> +a SAML token issued by the IDP/STS. This keystore is located in webapps/fedizidpsts/WEB-INF/classes/stsstore.jks (deployed)
> +or in services/sts/src/main/resources/stsstore.jks (source)
> +
>
> Building the demo using Maven
> -----------------------------
>
> Modified: cxf/fediz/trunk/examples/simpleWebapp/pom.xml
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/simpleWebapp/pom.xml?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/simpleWebapp/pom.xml (original)
> +++ cxf/fediz/trunk/examples/simpleWebapp/pom.xml Wed Jun 6 19:58:45 2012
> @@ -51,6 +51,7 @@
> <version>2.5</version>
> <scope>provided</scope>
> </dependency>
> +<!-- Required to cast Principal to FederationPrincipal -->
> <dependency>
> <groupId>org.apache.cxf.fediz</groupId>
> <artifactId>fediz-core</artifactId>
> @@ -58,12 +59,6 @@
> <scope>provided</scope>
> </dependency>
> <dependency>
> -<groupId>org.apache.cxf.fediz</groupId>
> -<artifactId>fediz-tomcat</artifactId>
> -<version>${project.version}</version>
> -<scope>provided</scope>
> -</dependency>
> -<dependency>
> <groupId>org.apache.commons</groupId>
> <artifactId>commons-lang3</artifactId>
> <version>3.0.1</version>
>
> Modified: cxf/fediz/trunk/examples/wsclientWebapp/README.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/wsclientWebapp/README.txt?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/wsclientWebapp/README.txt (original)
> +++ cxf/fediz/trunk/examples/wsclientWebapp/README.txt Wed Jun 6 19:58:45 2012
> @@ -70,6 +70,13 @@ Prerequisite
> Please review the README in the samples main directory before continuing.
> It's recommended to run the demo simpleWebapp first as this is an extended demo.
>
> +Copy the Fediz Configuration file into the directory 'conf' of the Tomcat installation. The configuration file
> +is located in src/main/config/fediz_config.xml of this example.
> +
> +This configuration references the java keystore 'conf/stsstore.jks' which contains the certificate to validate
> +a SAML token issued by the IDP/STS. This keystore is located in webapps/fedizidpsts/WEB-INF/classes/stsstore.jks (deployed)
> +or in services/sts/src/main/resources/stsstore.jks (source)
> +
>
> Building the demo using Maven
> -----------------------------
>
> Modified: cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml?rev=1347084&r1=1347083&r2=1347084&view=diff
> ==============================================================================
> --- cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml (original)
> +++ cxf/fediz/trunk/examples/wsclientWebapp/webapp/pom.xml Wed Jun 6 19:58:45 2012
> @@ -52,6 +52,7 @@
> <version>${tomcat.version}</version>
> <scope>provided</scope>
> </dependency>
> + <!-- Required to cast Principal to FederationPrincipal -->
> <dependency>
> <groupId>org.apache.cxf.fediz</groupId>
> <artifactId>fediz-core</artifactId>
> @@ -59,12 +60,6 @@
> <scope>provided</scope>
> </dependency>
> <dependency>
> - <groupId>org.apache.cxf.fediz</groupId>
> - <artifactId>fediz-tomcat</artifactId>
> - <version>${project.version}</version>
> - <scope>provided</scope>
> - </dependency>
> - <dependency>
> <groupId>org.apache.commons</groupId>
> <artifactId>commons-lang3</artifactId>
> <version>3.0.1</version>
>
> Added: cxf/fediz/trunk/release_notes.txt
> URL: http://svn.apache.org/viewvc/cxf/fediz/trunk/release_notes.txt?rev=1347084&view=auto
> ==============================================================================
> --- cxf/fediz/trunk/release_notes.txt (added)
> +++ cxf/fediz/trunk/release_notes.txt Wed Jun 6 19:58:45 2012
> @@ -0,0 +1,58 @@
> +Apache CXF Fediz 1.0.0 Release Notes
> +
> +1. Overview
> +
> +The 1.0.x versions of Apache CXF Fediz is the first version of Fediz that
> +provides the following features:
> +
> +* WS-Federation 1.0/1.1/1.2
> +* SAML 1.1/2.0 Tokens
> +* Custom token support
> +* Publish WS-Federation Metadata document
> +* Role information encoded as AttributeStatement in SAML 1.1/2.0 tokens
> +* Claims information provided by FederationPrincipal interface
> +
> +
> +2. Installation Prerequisites
> +
> +Before installing Apache CXF Fediz, make sure the following products,
> +with the specified versions, are installed on your system:
> +
> + * Java 6 Development Kit
> + * Apache Maven 2.2.1 or 3.x to build the samples
> +
> +
> +3. Building the Samples
> +
> +Building the samples included in the binary distribution is easy. Change to
> +the examples directory and follow the build instructions in the README.txt file
> +included with each sample.
> +
> +
> +4. Reporting Problems
> +
> +If you have any problems or want to send feedback of any kind, please e-mail the
> +CXF dev list, dev@cxf.apache.org. You can also file issues in JIRA at:
> +
> +http://issues.apache.org/jira/browse/FEDIZ
> +
> +
> +5. Migration notes:
> +
> +N.A.
> +
> +
> +6. Specific issues, features, and improvements fixed in this version
> +
> +** Bug
> +
> +** Improvement
> +
> +** New Feature
> +
> +** Task
> +
> +** Test
> +
> +
> +
>
>
--
Glen Mazza
Talend Community Coders
coders.talend.com
blog: www.jroller.com/gmazza