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: [email protected]
For additional commands, e-mail: [email protected]