Web User Manager - Tutorial

Overview

The Web User Manager is a web application to manage a web site members list. With this tool you will be able to add, find, modify and remove any members.

For each user login, the following can be defined:

• a password
• one or several groups to which the user belongs
• an expiration date

The group information will be used to define access permissions for files and directories.

To access the Web User Manager load URL: http://www.<your domain name>/usermanager

Startup Instructions

1. Define a database administrator password (first time only)
   
   We strongly recommend to define a database administration password. If you do not, anyone who is aware of this utility will be able to access and modify your members list.
   
   
2. Login as the Database Administrator
   
   If you defined a database administrator password, it is necessary to login to manage your member list.
   
   
3. Add, Find, Modify or Remove a member of your web site
   
   Once you are logged in, you can manage the members list of your web site. If this is your first use of the Web User Manager you might simply create one or two members to experiment with access permissions to files and resources of your web site.
   
   
4. Log off
   
   When you are done managing the members list we strongly recommend that you log off.
   
   
5. For more information, check the Advanced Information section.
   

Define a Database Administrator Password

To define a database administrator password:

1. Choose link Change DB Password.
2. If this is your first access to this option, leave field Old password blank and enter the password twice which you want to use to manage the members list. If a password was already defined, simply enter the current password (Old password) and enter the new password twice.
3. Press Submit.
4. If a success message is displayed, your new password is now active.

Login as the Database Administrator

To login as a database administrator:

1. Choose link Log In
2. Enter the Database Administrator Password (At this point, if no password is required to login, it means you did not define a Database Administrator Password).
3. Press Login. If a success message is displayed, your are logged in, and you can now manage the members list.

Add a User

To Add a User:

1. If not logged in, log in
2. Choose link Add User
3. Enter the requested information:
   - DAF Login: the user login to be entered in the browser authentication popup window.
   - DAF Password: the user password to be entered in the browser authentication popup window.
   - DAF groups (optional): one or several groups to which the user belongs. Groups must be separated with a semicolon (e.g., grp1;grp2;grp3).
   - Expiration Date (optional): After this date the account won't be usable.
   The date format is: YYYY/MM/DD, where YYYY is the year, MM the month and DD the day.
4. Press Add User. If a success message is displayed, the user is created and is now usable.

Find a User

To Find a User:

1. If not logged in, log in
2. Choose link Find User
3. Enter a user name
4. Press Find User. If the user name is valid, the user information should be displayed. If not valid, an error message will be returned.

Modify a User

To Modify a User:

1. If not logged in, log in
2. Choose link Modify User
3. Enter a user name
4. Press Find User. If the user name is valid, the user information should be displayed. If not valid an error message will be returned.
5. Modify any field
6. Press Modify User. If a success message is displayed, the user information was modified.

Remove a User

To Remove a User:

1. If not logged in, log in
2. Choose link Remove User
3. Enter a user name
4. Press Find User. If the user name is valid, the user information should be displayed. If not valid an error message will be returned.
5. Press Remove User. If a success message is displayed, the user was removed.

Log Off

Before leaving the Web User Manager, it is recommended that you log off. To do so, choose link Log Off.

Advanced Information

The user list is stored in a text file "/userdb/userdb.txt." This file can be downloaded and uploaded using FTP. Changes are active in real-time.

The format per line is:

<user name>:<user password>#<group>@YYYY-MM-DD

* expiration date is optional

The following example creates the user "phil" with the password "pass" and an expiration date of Jan. 1, 1999.

phil:pass#group1@1999-01-99

Philippe Tenenhaus
Version: 1.0 - 09/22/98