Author: markt Date: Wed Jul 27 09:13:36 2011 New Revision: 1151395 URL: http://svn.apache.org/viewvc?rev=1151395&view=rev Log: Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=51561 Recommend the use of digest.[bat|sh] to generate digests rather than calling RealmBase directly.
Modified: tomcat/trunk/webapps/docs/changelog.xml tomcat/trunk/webapps/docs/realm-howto.xml Modified: tomcat/trunk/webapps/docs/changelog.xml URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/changelog.xml?rev=1151395&r1=1151394&r2=1151395&view=diff ============================================================================== --- tomcat/trunk/webapps/docs/changelog.xml (original) +++ tomcat/trunk/webapps/docs/changelog.xml Wed Jul 27 09:13:36 2011 @@ -158,6 +158,11 @@ the implications of setting the path attribute on a Context element in server.xml. (markt) </update> + <fix> + <bug>51561</bug>: Update the Realm page within the documentation web + application to recommend the use of digest.[bat|sh] to generate digests + rather than calling RealmBase directly. (markt) + </fix> </changelog> </subsection> <subsection name="Other"> Modified: tomcat/trunk/webapps/docs/realm-howto.xml URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/realm-howto.xml?rev=1151395&r1=1151394&r2=1151395&view=diff ============================================================================== --- tomcat/trunk/webapps/docs/realm-howto.xml (original) +++ tomcat/trunk/webapps/docs/realm-howto.xml Wed Jul 27 09:13:36 2011 @@ -196,9 +196,7 @@ techniques are supported:</p> method will return the digested password.</li> <li>If you want to execute a command line utility to calculate the digested password, simply execute -<source> -java org.apache.catalina.realm.RealmBase \ - -a {algorithm} {cleartext-password} +<source>CATALINA_HOME/bin/digest.[bat|sh] -a {algorithm} {cleartext-password} </source> and the digested version of this cleartext password will be returned to standard output.</li> @@ -215,19 +213,8 @@ java org.apache.catalina.realm.RealmBase not specified in web.xml, the default value of <code>Authentication required</code> is used.</p> -<p>To use either of the above techniques, the following jar files will need -to be on your class path to make the <code>RealmBase</code> class available: -</p> - -<ul> - <li>$CATALINA_HOME/bin/tomcat-juli.jar</li> - <li>$CATALINA_HOME/lib/catalina.jar</li> - <li>$CATALINA_HOME/lib/tomcat-util.jar</li> -</ul> - <p>Non-ASCII usernames and/or passwords are supported using -<source>java org.apache.catalina.realm.RealmBase \ - -a {algorithm} -e {encoding} {input} +<source>CATALINA_HOME/bin/digest.[bat|sh] -a {algorithm} -e {encoding} {input} </source> but care is required to ensure that the non-ASCII input is correctly passed to the digester. --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org