[Savannah-cvs] [428] Tweak up user auth documentation

[bob]

Revision: 428
          
http://svn.savannah.gnu.org/viewvc/?view=rev&root=administration&revision=428
Author:   rwp
Date:     2021-01-07 17:13:14 -0500 (Thu, 07 Jan 2021)
Log Message:
-----------
Tweak up user auth documentation

Modified Paths:
--------------
    trunk/sviki/UserAuthentication.mdwn

Modified: trunk/sviki/UserAuthentication.mdwn
===================================================================
--- trunk/sviki/UserAuthentication.mdwn 2020-11-26 10:48:12 UTC (rev 427)
+++ trunk/sviki/UserAuthentication.mdwn 2021-01-07 22:13:14 UTC (rev 428)
@@ -15,8 +15,9 @@
 
 ### Database access
 
-On `internal0.savannah.gnu.org`, the following sql commands can be used to 
examine
-user accounts:
+In the SQL database, currently `internal0.savannah.gnu.org` but
+accessible from the collection of hosts, the following sql commands
+can be used to examine user accounts:
 
     $ echo "select
               user_id, user_name, email, realname,
@@ -33,8 +34,10 @@
 
 The `authorized_keys` field contains all the user's SSH public keys,
 concatenated with a `###` delimiter, as a one-line string.
-(The database currently contains some malformed/invalid keys - when
-a user uploaded invalid keys.)
+Users upload their GPG key and this data is stored in this database
+record.  Some users have uploaded malformed and invalid GPG key
+information.  Therefore some of these records are invalid due to
+having had invalid information uploaded.
 
 ### Reactivating a user
 
@@ -80,7 +83,6 @@
     vcs0:~# getent group gawk
     gawk:x:6731:ajschorr,arnold,eliz,jkahrs,scldad,wb8tyw
 
-
 ### Authentication mechanisms
 
 For VCS repositories (git/hg/bzr/svn/cvs on `vcs.sv.gnu.org`) and
@@ -151,7 +153,6 @@
 how it is called (but note that the page is out-dated: the script now
 runs as a cron job on `mgt0`, not `internal0`).
 
-
 ### ssh authentication
 
 The file `/etc/ssh/sshd_config` on `download0:` and `vcs0:` servers have the 
line:
@@ -246,7 +247,6 @@
     $ getent passwd agn
     agn:x:1557:1562:Assaf Gordon,,,:/home/a/agn:/bin/bash
 
-
 ### GNU webpages repository access for www members
 
 Members of the www group (= GNU webmasters) have write access to the