Adding users to your external authentication module
The way to add users to your external database is hopefully known to you. However, all
external authentication modules should adhere to the
protocol so you should either
be able to run the authentication program from the command line or use DMAdmin (windows GUI)
or NetAuth(web admin) to add users as well.
If you are using nwauth, for example, then to add a user with username=bob and password=secret,
run nwauth at a command prompt and enter,
NT:
cd c:\dmail
nwauth
set bob secret
quit
UNIX:
cd /usr/local/dmail
./nwauth
set bob secret
quit
The 'set' command above is the same for any authentication module.
NB: the form of the username which you add to the database will be one of the following,(using the username bob on a domain, domain1.com),
1. set bob secret
2. set bob@domain1.com secret
3. set dom1_bob secret
If you add the username to the database in the wrong form then users will not be able to login to the POP server.
If you are working on your first 'main domain' then option 1 is probably correct. Option 1 is used
for adding users to your main domain, except for when authent_domain is set to true (more below).
If you are adding a user to a virtual domain, then option 3 is probably correct. Option 3 is
only used when adding users to a virtual domain, except when authent_domain is set to true (more below).
Option 2, If you have set
authent_domain true
in the dmail.conf file then you MUST use option 2 on ALL domains.
Having authent_domain true set is our recommended option if you are doing a fresh install and you
don't have existing users in your users database. NB: if you change this setting now then you should restart both dsmtp and dpop.
(Use the tellsmtp command to check this setting,
tellsmtp config authent_domain
should respond that the setting has just one value 'true' if you have this setting set, otherwise it
is not set.)
If you are adding virtual domains, you should see the Domains section of the
manual for information on which form to use when adding users to the database.