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 =================================================================== --- docs/trunk/referenceGuide/en/modules/identity.xml 2007-01-30 22:33:11 UTC (rev 6128) +++ docs/trunk/referenceGuide/en/modules/identity.xml 2007-01-30 23:09:26 UTC (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 support in JBoss Portal. For additional information you need to study more about + 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="bold">jboss-porta.sar/META-INF/jboss-service.xml</emphasis> + in section: + </para> + <programlisting> + <![CDATA[ + <mbean + code="org.jboss.portal.identity.IdentityServiceControllerImpl" + name="portal:service=Module,type=IdentityServiceController" + xmbean-dd="" + xmbean-code="org.jboss.portal.jems.as.system.JBossServiceModelMBean"> + <xmbean/> + <depends>portal:service=Hibernate</depends> + <!--<depends>jboss.jca:service=DataSourceBinding,name=@portal.datasource.name@</depends>--> + <attribute name="JndiName">java:/portal/IdentityServiceController</attribute> + <attribute name="RegisterMBeans">true</attribute> + <attribute name="ConfigFile">conf/identity/identity-config.xml</attribute> + <attribute name="DefaultConfigFile">conf/identity/standardidentity-config.xml</attribute> + </mbean> + ]]> + </programlisting> + <para> + change <emphasis role="bold">identity-config.xml</emphasis> to + <emphasis role="bold">ldap_identity-config.xml</emphasis> + </para> + </listitem> + <listitem> + <para>Swap the names or content of files in + <emphasis role="bold">jboss-porta.sar/conf/identity/identity-config.xml</emphasis> + and + <emphasis role="bold">jboss-porta.sar/conf/identity/ldap_identity-config.xml</emphasis> + + </para> + </listitem> + <para> + After doing on of above changes you need to edit configuration 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=Directory 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 (described in configuration documentation) like those: + </para> + <programlisting> + <![CDATA[ + <option-group> + <group-name>common</group-name> + <option> + <name>userContainerDN</name> + <value>ou=People,dc=portal26,dc=jboss,dc=com</value> + </option> + <option> + <name>roleContainerDN</name> + <value>ou=Roles,dc=portal26,dc=jboss,dc=com</value> + </option> + </option-group> + ]]> + </programlisting> + + </itemizedlist> + </sect1> + <sect1> + <title>Identity configuration</title> + <para>TODO: About the format and architecture of identity configuration 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 =================================================================== --- docs/trunk/referenceGuide/en/modules/sso.xml 2007-01-30 22:33:11 UTC (rev 6128) +++ docs/trunk/referenceGuide/en/modules/sso.xml 2007-01-30 23:09:26 UTC (rev 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>