From portal-commits at lists.jboss.org Tue Jan 30 18:09:26 2007
Content-Type: multipart/mixed; boundary="===============3065373380056797963=="
MIME-Version: 1.0
From: portal-commits at lists.jboss.org
To: portal-commits at lists.jboss.org
Subject: [portal-commits] JBoss Portal SVN: r6129 -
 docs/trunk/referenceGuide/en/modules.
Date: Tue, 30 Jan 2007 18:09:26 -0500
Message-ID: <E1HC26Q-0000Op-HV@committer01.frg.pub.inap.atl.jboss.com>

--===============3065373380056797963==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: bdaw
Date: 2007-01-30 18:09:26 -0500 (Tue, 30 Jan 2007)
New Revision: 6129

Modified:
   docs/trunk/referenceGuide/en/modules/identity.xml
   docs/trunk/referenceGuide/en/modules/sso.xml
Log:
few more things in identity and sso toc

Modified: docs/trunk/referenceGuide/en/modules/identity.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- docs/trunk/referenceGuide/en/modules/identity.xml	2007-01-30 22:33:11 U=
TC (rev 6128)
+++ docs/trunk/referenceGuide/en/modules/identity.xml	2007-01-30 23:09:26 U=
TC (rev 6129)
@@ -405,6 +405,108 @@
             </itemizedlist>
         </sect2>
     </sect1>
-   =

+    <sect1>
+        <title>How to enable LDAP in JBoss Portal</title>
+        <para>Here are just few simple steps you'll need to enable LDAP su=
pport in JBoss Portal. For additional information you need to study more ab=
out
+        configuration of identity and specific implementations of identity=
 modules</para>
+        <para>There are two ways to achive this goal:</para>
+        <itemizedlist>
+            <listitem>
+                <para>In <emphasis role=3D"bold">jboss-porta.sar/META-INF/=
jboss-service.xml</emphasis>
+                    in section:
+                </para>
+                <programlisting>
+                    <![CDATA[
+                    <mbean
+                        code=3D"org.jboss.portal.identity.IdentityServiceC=
ontrollerImpl"
+                        name=3D"portal:service=3DModule,type=3DIdentitySer=
viceController"
+                        xmbean-dd=3D""
+                        xmbean-code=3D"org.jboss.portal.jems.as.system.JBo=
ssServiceModelMBean">
+                        <xmbean/>
+                        <depends>portal:service=3DHibernate</depends>
+                        <!--<depends>jboss.jca:service=3DDataSourceBinding=
,name=3D@portal.datasource.name@</depends>-->
+                        <attribute name=3D"JndiName">java:/portal/Identity=
ServiceController</attribute>
+                        <attribute name=3D"RegisterMBeans">true</attribute>
+                        <attribute name=3D"ConfigFile">conf/identity/ident=
ity-config.xml</attribute>
+                        <attribute name=3D"DefaultConfigFile">conf/identit=
y/standardidentity-config.xml</attribute>
+                    </mbean>
+                    ]]>
+                </programlisting>
+                <para>
+                    change <emphasis role=3D"bold">identity-config.xml</em=
phasis>  to
+                    <emphasis role=3D"bold">ldap_identity-config.xml</emph=
asis> =

+                </para>
+            </listitem>
+            <listitem>
+                <para>Swap the names or content of files in
+                    <emphasis role=3D"bold">jboss-porta.sar/conf/identity/=
identity-config.xml</emphasis>
+                    and
+                    <emphasis role=3D"bold">jboss-porta.sar/conf/identity/=
ldap_identity-config.xml</emphasis>
+                    =

+                    </para>
+            </listitem>
+            <para>
+                After doing on of above changes you need to edit configura=
tion file that you choose to
+                use (identity-config.xml or ldap_identity-config.xml) and =
configure LDAP connection options in section:
+            </para>
+            <programlisting>
+                <![CDATA[
+                <datasource>
+                    <name>LDAP</name>
+                    <config>
+                        <option>
+                            <name>host</name>
+                            <value>jboss.com</value>
+                        </option>
+                        <option>
+                            <name>port</name>
+                            <value>10389</value>
+                        </option>
+                        <option>
+                            <name>adminDN</name>
+                            <value>cn=3DDirectory Manager</value>
+                        </option>
+                        <option>
+                            <name>adminPassword</name>
+                            <value>qpq123qpq</value>
+                        </option>
+                    </config>
+                </datasource>
+            ]]>
+            </programlisting>
+            <para>
+                You also need to specify options for your LDAP tree (descr=
ibed in configuration documentation) like those:
+            </para>
+            <programlisting>
+                <![CDATA[
+                    <option-group>
+                        <group-name>common</group-name>
+                        <option>
+                            <name>userContainerDN</name>
+                            <value>ou=3DPeople,dc=3Dportal26,dc=3Djboss,dc=
=3Dcom</value>
+                        </option>
+                        <option>
+                            <name>roleContainerDN</name>
+                            <value>ou=3DRoles,dc=3Dportal26,dc=3Djboss,dc=
=3Dcom</value>
+                        </option>
+                    </option-group>
+                ]]>
+            </programlisting>
 =

+
+        </itemizedlist>
+    </sect1>
+    <sect1>
+        <title>Identity configuration</title>
+        <para>TODO: About the format and architecture of identity configur=
ation files</para>
+
+    </sect1>
+    <sect1>
+        <title>Identity modules implementations</title>
+        <para>TODO:</para>
+    </sect1>
+    <sect1>
+        <title>Possible configuration scenarios with LDAP and RDBMS</title>
+        <para>TODO:</para>
+    </sect1>
 </chapter>

Modified: docs/trunk/referenceGuide/en/modules/sso.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- docs/trunk/referenceGuide/en/modules/sso.xml	2007-01-30 22:33:11 UTC (r=
ev 6128)
+++ docs/trunk/referenceGuide/en/modules/sso.xml	2007-01-30 23:09:26 UTC (r=
ev 6129)
@@ -6,8 +6,19 @@
          <email>boleslaw.dawidowicz at jboss dot com</email>
       </author>
    </chapterinfo>
-   <title>Authentication</title>
+   <title>Single Sign ON</title>
    <para>This chapter describes how to setup SSO in JBoss Portal</para>
-   =

+   <sect1>
+       <title>Overview of SSO in portal</title>
+       <para>TODO:</para>
+   </sect1>
+   <sect1>
+       <title>Using Tomcat Valve</title>
+       <para>TODO:</para>
+   </sect1>
+   <sect1>
+       <title>Using external authentication providers</title>
+       <para>TODO:</para>
+   </sect1>
 =

 </chapter>


--===============3065373380056797963==--