fixes to the "Using an external password validation source"...

...customisation example (bugs [SF#153640] and [SF#155108])

Author: Richard Jones

CHANGES.txt

@@ -18,6 +18,8 @@ Fixed:
 - change AUTOCOMMIT=OFF to AUTOCOMMIT=0 for MySQL (sf bug 1143707)
 - compile message objects in 'setup.py build'
 - use backend datatype for journal timestamps in RDBMSes
+- fixes to the "Using an external password validation source"
+  customisation example (sf bugs 1153640 and 1155108)
 
 
 2005-02-17 0.8.1

doc/customizing.txt

@@ -2,7 +2,7 @@
 Customising Roundup
 ===================
 
-:Version: $Revision: 1.172 $
+:Version: $Revision: 1.173 $
 
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -3246,6 +3246,12 @@ Using External User Databases
 Using an external password validation source
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. note:: You will need to either have an "admin" user in your external
+          password source *or* have one of your regular users have
+          the Admin Role assigned. If you need to assign the Role *after*
+          making the changes below, you may use the ``roundup-admin``
+          program to edit a user's details.
+
 We have a centrally-managed password changing system for our users. This
 results in a UN*X passwd-style file that we use for verification of
 users. Entries in the file consist of ``name:password`` where the
@@ -3262,6 +3268,7 @@ need to override the standard ``verifyPassword`` method defined in
 following is added as ``externalpassword.py`` in the tracker ``extensions``
 directory::
 
+    import os, crypt
     from roundup.cgi.actions import LoginAction    
 
     class ExternalPasswordLoginAction(LoginAction):
@@ -3342,8 +3349,8 @@ tracker we're to work on::
 
 Next we read in the *passwd* file from the tracker home::
 
-    # read in the users
-    file = os.path.join(tracker_home, 'users.passwd')
+    # read in the users from the "passwd.txt" file
+    file = os.path.join(tracker_home, 'passwd.txt')
     users = [x.strip().split(':') for x in open(file).readlines()]
 
 Handle special users (those to ignore in the file, and those who don't

doc/index.txt

@@ -73,6 +73,7 @@ Duncan Booth,
 Seb Brezel,
 J Alan Brogan,
 Titus Brown,
+Steve Byan,
 Godefroid Chapelle,
 Roch'e Compaan,
 Wil Cooley,