|
Manage Users |
|
|
|
< < | Some of the features below may be disabled, depending on your TWiki
configuration. |
> > | Some of the features below may be disabled, depending on your TWiki configuration. |
|
Authentication and Access Control
|
|
< < | |
> > | |
|
Register User |
|
< < | You don't have to have user home pages in TWiki for Authentication to
work - see TWikiUserAuthentication for details. |
> > | You don't have to have user home pages in TWiki for Authentication to work - see TWikiUserAuthentication for details. |
| |
|
< < | |
> > | |
|
Change, Reset and Install Passwords
Note that the below features are only relevant when you use an internal password manager where TWiki can set and reset 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
- ChangeEmailAddress changes the hidden email address stored in the password file
|
> > |
- 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
- ChangeEmailAddress changes the hidden email address stored in the password file
|
|
Changing User Account Names
To change the user's WikiName: |
|
< < |
- Rename the user's TWiki homepage in the Main web, such as from
JaneSmith to JaneMiller .
- Fix backlinks in the Main web only
|
> > |
- Rename the user's TWiki homepage in the Main web, such as from
JaneSmith to JaneMiller .
- Fix backlinks in the Main web only
|
|
-
- Make sure the group topics are updated (if any.)
|
|
< < |
- Edit the Main.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:
|
> > |
- Edit the Main.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:
|
| %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 authentication server (e.g. Active Directory)
- In TWiki's Main.TWikiUsers topic, fix the mapping from login name to WikiName:
|
> > |
- The login name needs to be changed in the authentication server (e.g. Active Directory)
- In TWiki's Main.TWikiUsers topic, fix the mapping from login name to WikiName:
|
| * JaneSmith - jsmith - 13 Sep 2006
to:
* JaneMiller - jmiller - 13 Sep 2006 |
|
To remove a user account (FredQuimby, who logs in as "fred"): |
|
< < |
- 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.
- Remove the
FredQuimby - fred line from the Main.TWikiUsers topic
- Remove
FredQuimby from all groups and from all the ALLOWWEB/ALLOWTOPIC... declarations, if any. 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.
- [optional] Delete their user topic Main.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 around, replace the topic content with a note to that effect.
The existence of the UserName topic should also prevent that user name from being re-used, sealing the potential security hole regarding inherited permissions.. |
> > |
- 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.
- Remove the
FredQuimby - fred line from the Main.TWikiUsers topic
- Remove
FredQuimby from all groups and from all the ALLOWWEB/ALLOWTOPIC... declarations, if any. 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.
- [optional] Delete their user topic Main.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 around, replace the topic content with a note to that effect. The existence of the UserName topic should also prevent that user name from being re-used, sealing the potential security hole regarding inherited permissions.. |
|
Customizing registration Emails. |
|
> > | |
| TWiki's Registration can send 3 emails who's output is governed by templates: |
|
> > | |
|
- User registration confirmation -
templates/registerconfirm.tmpl
- User registration notification -
templates/registernotify.tmpl
- Email to notify the TWiki admin of registration -
templates/registernotifyadmin.tmpl
|
|
- User registration notification -
templates/registernotify.tmpl
- Email to notify the TWiki admin of registration -
templates/registernotifyadmin.tmpl
|
|
< < | As these are TWikiTemplates, they can be customized and selected using the SKIN path setting.
Because there are default tmpl files in the templates dir, this cannot use Template topics. |
> > | As these are TWikiTemplates, they can be customized and selected using the SKIN path setting. Because there are default tmpl files in the templates dir, this cannot use Template topics. |
| |
|
< < | These template files have a specific format that matches the raw format of emails sent via SMTP,
so be careful and test your changes. It is easiest to start by copying the default templates: |
> > | These template files have a specific format that matches the raw format of emails sent via SMTP, so be careful and test your changes. It is easiest to start by copying the default templates: |
|
cd twiki/templates |
| cp registerconfirm.tmpl registerconfirm.myskin.tmpl
cp registernotifyadmin.tmpl registernotifyadmin.myskin.tmpl
|
|
< < | then add myskin to the beginning of the SKIN setting in TWikiPreferences. |
> > | then add myskin to the beginning of the SKIN setting in TWikiPreferences. |
|
From this point on, your myskin templates will be used for the registration emails. |
|
< < | To make it possible for TWikiUsers to modify the email contents, you could use a parameterized %INCLUDE%
statement in your customized version. eg: |
> > | To make it possible for TWikiUsers to modify the email contents, you could use a parameterized %INCLUDE% statement in your customized version. e.g.: |
|
From: %WIKIWEBMASTERNAME% <%WIKIWEBMASTER%> |
| EMAILADDRESS="%EMAILADDRESS%"
}%
|
|
< < |
- note the use of %WIKINAME%, %FIRSTLASTNAME%, %EMAILADDRESS% passed in from the INCLUDE so that the topic below is similar to the original template
|
| |
|
< < | and then create a topic Main.RegisterNotifyEmail: |
> > | Note: The use of %WIKINAME%, %FIRSTLASTNAME%, %EMAILADDRESS% passed in from the INCLUDE so that the topic below is similar to the original template.
And then create a topic Main.RegisterNotifyEmail: |
|
Welcome to %WIKITOOLNAME%.
|
| Submitted content:
%FORMDATA% |
|
< < |
META PREFERENCE |
name="ALLOWTOPICCHANGE" title="ALLOWTOPICCHANGE" type="Set" value="Main.TWikiAdminGroup" |
|
> > |
META PREFERENCE |
name="ALLOWTOPICCHANGE" title="ALLOWTOPICCHANGE" type="Set" value="Main.TWikiAdminGroup" |
|
| |
|
< < |
- remember to secure the topic appropriately to prevent attackers from getting emailed sensitive passwords.
|
> > |
Note: Remember to secure the topic appropriately to prevent attackers from getting emailed sensitive passwords. |
|
Related Topics: AdminDocumentationCategory |