yoavs 2004/11/17 08:50:31 Modified: webapps/docs changelog.xml realm-howto.xml Log: Bugzilla 32276: small fix to Realm How-To. Revision Changes Path 1.166 +3 -0 jakarta-tomcat-catalina/webapps/docs/changelog.xml Index: changelog.xml =================================================================== RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/changelog.xml,v retrieving revision 1.165 retrieving revision 1.166 diff -u -r1.165 -r1.166 --- changelog.xml 17 Nov 2004 15:00:48 -0000 1.165 +++ changelog.xml 17 Nov 2004 16:50:31 -0000 1.166 @@ -40,6 +40,9 @@ <fix> <bug>32130</bug>: Add safety check to FileStore#keys method. (yoavs) </fix> + <update> + <bug>32276</bug>: Add developer info to Realm How-To. (yoavs) + </update> </changelog> </subsection> </section> 1.21 +12 -5 jakarta-tomcat-catalina/webapps/docs/realm-howto.xml Index: realm-howto.xml =================================================================== RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/realm-howto.xml,v retrieving revision 1.20 retrieving revision 1.21 diff -u -r1.20 -r1.21 --- realm-howto.xml 13 Nov 2004 11:17:33 -0000 1.20 +++ realm-howto.xml 17 Nov 2004 16:50:31 -0000 1.21 @@ -8,6 +8,7 @@ <properties> <author email="[EMAIL PROTECTED]">Craig R. McClanahan</author> + <author email="[EMAIL PROTECTED]">Yoav Shapira</author> <author email="[EMAIL PROTECTED]">Andrew R. Jaquith</author> <title>Realm Configuration HOW-TO</title> </properties> @@ -109,9 +110,14 @@ </ul> <p>It is also possible to write your own <code>Realm</code> implementation, -and integrate it with Tomcat 5. However, doing this is beyond the scope of -this document. See (<strong>FIXME</strong> - reference to developer stuff) -for more information.</p> +and integrate it with Tomcat 5. To do so, you need to: +<ul> + <li>Implement <code>org.apache.catalina.Realm</code>,</li> + <li>Place your compiled realm in $CATALINA_HOME/server/lib,</li> + <li>Declare your realm as described in the "Configuring a Realm" section below,</li> + <li>Declare your realm to the <a href="mbeans-descriptor-howto.html">MBeans Descriptor</a>.</li> +</ul> +</p> </subsection> @@ -128,8 +134,9 @@ ... other attributes for this implementation .../> </source> -<p>The <code><Realm></code> element can be nested inside one of three -different elements, which has a direct impact on the "scope" of that Realm +<p>The <code><Realm></code> element can be nested inside any one of +of the following <code>Container</code> elements. The location of the +Realm element has a direct impact on the "scope" of that Realm (i.e. which web applications will share the same authentication information): </p> <ul>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]