Francois Gouget : testbot: Document the user account management procedures.

[Alexandre Julliard]

Module: tools
Branch: master
Commit: eb909209aa2686f6fd5ba093e39fbb11b9ce35d6
URL:    http://source.winehq.org/git/tools.git/?a=commit;h=eb909209aa2686f6fd5ba093e...

Author: Francois Gouget 
Date:   Wed Mar 13 16:37:38 2013 +0100

testbot: Document the user account management procedures.

---

testbot/README          |   25 +++++++++++++++++++++++++
 testbot/doc/INSTALL.txt |    3 +++
 2 files changed, 28 insertions(+), 0 deletions(-)

diff --git a/testbot/README b/testbot/README
index 4f4cbc9..f15f82a 100644
--- a/testbot/README
+++ b/testbot/README
@@ -68,3 +68,28 @@ WineTestBot:
 ---------------

See the doc/INSTALL.txt file.
+
+
+5. USER ACCOUNT MANAGEMENT
+--------------------------
+
+When a user asks for an account, a provisional account is created immediately
+but has to be 'activated' before it can be used. Also an email is sent to the
+WineTestBot administrators.
+
+If the request is considered to be illegitimate / spam, the administrator
+should directly delete the provisional account. Otherwise the account should
+be approved.
+
+Approving the account will generate a 'password reset code' and send an email
+to the user with a URL to visit to set the account password. That will activate
+the account and make it usable.
+
+
+Notes:
+* Existing accounts can be suspended by unchecking the 'active' field. This
+  prevents the user from logging in and changing the password.
+* Only accounts that have the 'wine-devel' role can submit jobs. So
+  administrators who also want to submit jobs should add it to their account
+  (see the doc/INSTALL.txt file).
+* FIXME: Document how the LDAP integration works.
diff --git a/testbot/doc/INSTALL.txt b/testbot/doc/INSTALL.txt
index 4c14668..a5655ec 100644
--- a/testbot/doc/INSTALL.txt
+++ b/testbot/doc/INSTALL.txt
@@ -58,6 +58,9 @@ General setup for the web site:
   the resetcode you just updated and a new password.
 - Make yourself admin by adding a row to UserRoles:
     mysql> insert into UserRoles values('<username>', 'admin');
+- If you want to be able to submit jobs from the same account you will likely
+  need to also give it the 'wine-devel' role:
+    mysql> insert into UserRoles values('<username>', wine-devel);
 - When you refresh the home page, you should now have an "Admin" menu
   in the sidebar.