Author: anil.saldhana(a)jboss.com Date: 2009-02-20 15:26:43 -0500 (Fri, 20 Feb 2009) New Revision: 341 Modified: identity-doc/trunk/ identity-doc/trunk/DeveloperGuide/ identity-doc/trunk/DeveloperGuide/src/ identity-doc/trunk/DeveloperGuide/src/main/ identity-doc/trunk/DeveloperGuide/src/main/docbook/ identity-doc/trunk/DeveloperGuide/src/main/docbook/DeveloperGuide.xml identity-doc/trunk/UserGuide/ identity-doc/trunk/UserGuide/src/ identity-doc/trunk/UserGuide/src/main/ identity-doc/trunk/UserGuide/src/main/docbook/ identity-doc/trunk/UserGuide/src/main/docbook/UserGuide.xml identity-doc/trunk/images/ identity-doc/trunk/parent/ Log: doc changes Property changes on: identity-doc/trunk ___________________________________________________________________ Name: svn:ignore + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/DeveloperGuide ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/DeveloperGuide/src ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/DeveloperGuide/src/main ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/DeveloperGuide/src/main/docbook ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Modified: identity-doc/trunk/DeveloperGuide/src/main/docbook/DeveloperGuide.xml =================================================================== --- identity-doc/trunk/DeveloperGuide/src/main/docbook/DeveloperGuide.xml 2009-02-20 03:29:58 UTC (rev 340) +++ identity-doc/trunk/DeveloperGuide/src/main/docbook/DeveloperGuide.xml 2009-02-20 20:26:43 UTC (rev 341) @@ -13,7 +13,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude" /> <releaseinfo> - 1.0.0.alpha1. + 1.0.0.alpha2. </releaseinfo> </bookinfo> Property changes on: identity-doc/trunk/UserGuide ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/UserGuide/src ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/UserGuide/src/main ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/UserGuide/src/main/docbook ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Modified: identity-doc/trunk/UserGuide/src/main/docbook/UserGuide.xml =================================================================== --- identity-doc/trunk/UserGuide/src/main/docbook/UserGuide.xml 2009-02-20 03:29:58 UTC (rev 340) +++ identity-doc/trunk/UserGuide/src/main/docbook/UserGuide.xml 2009-02-20 20:26:43 UTC (rev 341) @@ -4,6 +4,7 @@ <!ENTITY % RH-ENTITIES SYSTEM "Common_Config/rh-entities.ent"> ]> <book> + <bookinfo> <title>JBoss Identity Federation</title> @@ -13,7 +14,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude" /> <releaseinfo> - 1.0.0.alpha1. + 1.0.0.alpha2. </releaseinfo> @@ -80,16 +81,14 @@ to be either downloaded separately or as part of the Java JDK or as part of JBoss Application Server. </para> - <itemizedlist> + <para> + Download the ZIP version of the JBoss Identity Community Platform. + Place the unzipped jar files in the lib directory of tomcat + or JBoss AS. Additionally ensure that the following dependencies + are met. + </para> + <itemizedlist> <listitem> - <para> JBoss Identity Federation Library - </para> - </listitem> - <listitem> - <para> JBoss XACML Library (jboss-xacml.jar and jboss-sunxacml.jar) - </para> - </listitem> - <listitem> <para> JAXB V2 Library </para> </listitem> @@ -147,12 +146,13 @@ </para> <note> <para>The IDP and the SP can be a JBoss Application Server or a Tomcat instance. + Please note that the instructions for Tomcat and JBAS are different. </para> </note> - <section><!-- Section on configuring the Identity Provider --> - <title>Configuring the Identity Provider (IDP) </title> + <section><!-- Section on configuring the Identity Provider--> + <title>Configuring the Identity Provider (IDP)</title> <note> <title>Check list for configuring the IDP</title> @@ -289,8 +289,9 @@ to the Service Providers. </para> </section><!-- End Section: Configure IDFed Config File - IDP --> - - </section> <!-- End Section on configuring the Identity Provider --> + + + </section> <!-- End Section on configuring the Identity Provider--> <section> <!-- Section:configure the SP --> @@ -307,6 +308,8 @@ </listitem> <listitem>Configure the jboss-idfed.xml for the SP configuration. </listitem> + <listitem>Perform additional steps if the SP is running on JBoss Application Server. + </listitem> </orderedlist> </note> @@ -438,6 +441,46 @@ </para> </section><!-- End Section: Configure IDFed Config File - SP --> + <section> <!-- Section: Additional steps for JBAS based SP --> + <title>Additional Steps for JBoss AS based SP</title> + <para> Configure a <emphasis role="italic">jboss-web.xml</emphasis> file in the + WEB-INF directory of your SP web application. + </para> + + <programlisting role="xml"> + &lt;?xml version="1.0" encoding="UTF-8"?&gt; + &lt;!DOCTYPE jboss-web + PUBLIC "-//JBoss//DTD Web Application 2.4//EN" + "http://www.jboss.org/j2ee/dtd/jboss-web_4_0.dtd"&gt; + &lt;jboss-web&gt; + &lt;security-domain&gt;java:/jaas/sp&lt;/security-domain&gt; + &lt;/jboss-web&gt; + </programlisting> + + <note> + <para> + In this example, we have specified a security domain of "sp". + You can use any security domain name of your choice as long as + you configure the login module in the next step appropriately. + </para> + </note> + + <para> + Configure the login module in conf/login-config.xml of your JBoss + AS server configuration. + </para> + <programlisting role="xml"> + &lt;application-policy name = "sp"&gt; + &lt;authentication&gt; + &lt;login-module + code = "org.jboss.identity.federation.bindings.jboss.auth.SAML2LoginModule" /&gt; + &lt;/authentication&gt; + &lt;/application-policy&gt; + </programlisting> + + </section> <!-- End Section: additional steps for JBAS SP --> + + </section><!-- End Section:configure the SP --> </section><!-- End Section: SAML HTTP/Redirect Binding --> Property changes on: identity-doc/trunk/images ___________________________________________________________________ Name: svn:ignore - target .settings .target-eclipse + .project .classpath target target-eclipse .metadata Property changes on: identity-doc/trunk/parent ___________________________________________________________________ Name: svn:ignore + .project .classpath target target-eclipse .metadata