head 1.5; access; symbols; locks; strict; comment @# @; 1.5 date 2007.01.16.04.11.56; author TWikiContributor; state Exp; branches; next 1.4; 1.4 date 2006.06.25.16.26.25; author TWikiContributor; state Exp; branches; next 1.3; 1.3 date 2006.04.01.05.55.08; author TWikiContributor; state Exp; branches; next 1.2; 1.2 date 2006.02.01.12.01.17; author TWikiContributor; state Exp; branches; next 1.1; 1.1 date 2004.08.15.08.14.20; author PeterThoeny; state Exp; branches; next ; desc @none @ 1.5 log @buildrelease @ text @%META:TOPICINFO{author="TWikiContributor" date="1158277691" format="1.1" version="5"}% %TOC% %STARTINCLUDE% ---# Manage Users _Register users on your TWiki site; change/reset/install passwords; remove user accounts_ ---++ Authentication and Access Control * TWikiUserAuthentication describes options of user authentication * TWikiAccessControl describes how to define groups and how to restrict access to content ---++ Register User It is not necessary to have user home pages in the TWiki system for Authentication to work - see TWikiUserAuthentication for details. * TWikiRegistration is for users to fill out a form * %TWIKIWEB%.NewUserTemplate can be changed to customize user home pages, it can optionally use the %MAINWEB%.UserForm to define user fields as meta data * BulkRegistration is for administrators to use to set up one or more accounts: either from a table or from an external file ---++ Change, Reset and Install Passwords * ChangePassword is for users who can remember their password and want to change it * ResetPassword is for users who cannot remember their password; a system generated password is e-mailed to them * BulkResetPassword if for administrators who want to reset many passwords at once ---++ Changing User Account Names To change the user's WikiName: * Rename the user's TWiki homepage in the %MAINWEB% web, such as from =JaneSmith= to =JaneMiller=. * Fix backlinks in the %MAINWEB% web only * Make sure the group topics are updated (if any.) * Edit the [[%MAINWEB%.TWikiUsers]] topic and move the user's entry so that the list is in proper alphabetical order. * Recreate the old topic with a pointer to the new topic, so that links in other webs work properly. Example content:%BR% =%M% Jane Smith is now known as !JaneMiller= If external authentication is used and you want to change the login name: * The login name needs to be changed in the directory server, such as AD or LDAP * In TWiki's [[%MAINWEB%.TWikiUsers]] topic, fix the mapping from login name to WikiName such as from:%BR% =  * !JohnSmith - john - 13 Sep 2006= %BR% to: %BR% =  * !JohnSmith - jsmith - 13 Sep 2006= ---++ Removing User Accounts To remove a user account (FredQuimby, who logs in as "fred"): 1 If you are using a =.htpasswd= file, edit the =.htpasswd= file to delete the line starting =fred:= * *Warning:* Do *not* use the Apache =htpasswd= program with =.htpasswd= files generated by TWiki! =htpasswd= wipes out email addresses that TWiki plants in the info fields of this file. 2 Remove the =FredQuimby - fred= line from the %MAINWEB%.TWikiUsers topic 3 Remove =FredQuimby= from all groups and from all the =ALLOWWEB/ALLOWTOPIC...= declarations, if any.%BR% __Note:__ If you fail to do this you risk creating a security hole, as the next user to register with the wikiname FredQuimby will inherit the old FredQuimby's permissions. 4 _[optional]_ Delete their user topic %MAINWEB%.FredQuimby (including attachments, if any.) __Note:__ Consider leaving the user topic file in place so their past signatures and revision author entries don't end up looking like AnUncreatedTopic. If you want to make it clear the user is no longer with the organization or has been banished, replace the topic content with a note to that effect. The existance of the UserName topic should also prevent that user name from being re-used, sealing the potential security hole regarding inherited permissions.. __Related Topics:__ AdminDocumentationCategory @ 1.4 log @buildrelease @ text @d1 1 a1 1 %META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="4"}% d27 17 d52 1 a52 1 4 _[optional]_ Delete their user topic %MAINWEB%.FredQuimby. @ 1.3 log @buildrelease @ text @d1 1 a1 1 %META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="3"}% d32 1 @ 1.2 log @buildrelease @ text @d1 1 a1 1 %META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="2"}% d10 2 a11 2 * TWikiUserAuthentication describes options of user authentication * TWikiAccessControl describes how to define groups and how to restrict access to content d17 3 a19 3 * TWikiRegistration is for users to fill out a form * %TWIKIWEB%.NewUserTemplate can be changed to customize user home pages, it can optionally use the %MAINWEB%.UserForm to define user fields as meta data * BulkRegistration is for administrators to use to set up one or more accounts: either from a table or from an external file d23 3 a25 3 * ChangePassword is for users who can remember their password and want to change it * ResetPassword is for users who cannot remember their password; a system generated password is e-mailed to them * BulkResetPassword if for administrators who want to reset many passwords at once d31 4 a34 4 1 If you are using a =.htpasswd= file, edit the =.htpasswd= file to delete the line starting =fred:= 2 Remove the =FredQuimby - fred= line from the %MAINWEB%.TWikiUsers topic 3 Remove =FredQuimby= from all groups and from all the =ALLOWWEB/ALLOWTOPIC...= declarations, if any.%BR% __Note:__ If you fail to do this you risk creating a security hole, as the next user to register with the wikiname FredQuimby will inherit the old FredQuimby's permissions. 4 _[optional]_ Delete their user topic %MAINWEB%.FredQuimby. @ 1.1 log @none @ text @d1 1 a1 1 %META:TOPICINFO{author="PeterThoeny" date="1092557660" format="1.0" version="1.1"}% d5 1 d15 2 d18 2 a19 1 * NewUserTemplate can be changed to customize user home pages d23 3 a25 3 * ChangePassword is for users who remember their password * ResetPassword is for users who do _not_ remember their password; they are asked to send a request to the site administrator to install a new password * InstallPassword is for the site administrator to install a password d29 1 a29 6 To remove a user account: 1 Edit the =data/.htpasswd= file to delete their entry (only applies if you are using a .htpasswd file) 2 Remove the =FredQuimby= line from the %MAINWEB%.TWikiUsers topic 3 Remove user from all groups and from all the =ALLOWWEB/ALLOWTOPIC...= declarations, if any.%BR% __Note:__ Otherwise this is a security hole as the first one to re-register with this name will be granted the permissions of the previous user. 4 _[optional]_ Remove their topic files: =data/%MAINWEB%/FredQuimby.txt= and =data/%MAINWEB%/FredQuimby.txt,v= d31 4 a34 1 __Note:__ Consider leaving the user topic file in place so their past signatures and revision author entries don't end up looking like AnUncreatedTopic. If you want to make it clear the user is inactive on your site (e.g. %MAINWEB%.PeterThoeny) or has been banished add a note to that effect and write protect the page (TWikiAccessControl). The existance of the UserName topic prevent that user name from being re-used. d36 1 a36 2 -- TWiki:Main.MattWilkie - 21 Jul 2003 %BR% -- TWiki:Main.PeterThoeny - 15 Aug 2004 d38 1 @