Authentication Settings Tables:

For all examples below the the following apply:

  • Main domain is netwin.co.nz with the IP address 1.2.3.4
  • server name is mail.netwin.co.nz
  • test user on the main domain is 'test'
  • virtual domain if there is one is computers.com, with suffix of @computers.com OR IP address of 9.9.9.9
  • test user on virtual domain is sales (sales@computers.com)
  • prefix on virtual domain is 'cc_'
  • NB: For domain specific settings in CWMail and NetAuth the settings go within a 'vhost' section

List of Tables:

  1. Ex1: Just one domain, authent_domain true
  2. Ex2: Ex1 with 1 suffix based virtual domain

Tables comparing product settings

The following tables show you what settings equate to each other in each of the products' configuration file.

Table 1: Domain used in user database with authent_domain true:
(domain added onto the end of the username, as it appears in user database, e.g. nwauth.add)
NB: the '@' symbol is always implied within the user database

Config File + Domain:Equivalent Settings:Old Equivalent Settings:
dmail.conf (all domains) authent_domain true 
dmail.conf (main domain) host_domain netwin.co.nz
(must be first host_domain setting)
host_domain netwin.co.nz
dpop_host netwin.co.nz
(pre DMail 2.7)
dmail.conf (suffix vdomain) vdomain cc @computers.com computers.com c:\dmail\in\computers
(3rd item in vdomain line = computers.com)
 
dmail.conf (IP vdomain) vdomain cc 9.9.9.9 computers.com c:\dmail\in\computers
(3rd item in vdomain line = computers.com)
 
cwmail.iniN.A. - no setting for any domain 
netauth.ini (main domain)domain netwin.co.nz  
netauth.ini (suffix vdomain)domain computers.com  
netauth.ini (IP vdomain)domain computers.com  

Table 2: Prefix used in user database (authent_domain false):
(prefix prepended onto the username, as it appears in user database, e.g. nwauth.add)

Config File + Domain:Equivalent Settings:Old Equivalent Settings:
dmail.conf (all domains) authent_domain false 
dmail.conf (main domain) no extra settings as no prefix on usernames for main domain 
dmail.conf (suffix vdomain) vdomain cc @computers.com computers.com c:\dmail\in\computers
vdomain_separator _
(1st item in vdomain line together with separator
give 'cc_' )
 
dmail.conf (IP vdomain) vdomain cc 9.9.9.9 computers.com c:\dmail\in\computers
vdomain_separator _
(1st item in vdomain line together with separator
give 'cc_' )
 
cwmail.iniN.A. - no setting for any domain 
netauth.ini (main domain)prefix NULL
(tells NetAuth to put no prefix on main domain usernames,
as no prefix on usernames for main domain)
 
netauth.ini (suffix vdomain)prefix cc_
(includes separator)
prefix cc
prefix_separator _
(pre version 4, e.g. 3.0e, use 2 setttings)
netauth.ini (IP vdomain)prefix cc_
(includes separator)
prefix cc
prefix_separator _
(pre version 4, e.g. 3.0e, use 2 setttings)

Table 3: Suffix used for POP login (suffix based vdomain):
(How to set the suffix that the user should enter on the end of their username when they login to the POP server directly - with the settings below CWMail will put the suffix on for the user when they login with their normal username)

Config File + Domain:Equivalent Settings:Old Equivalent Settings:
dmail.conf (all domains) no general setting 
dmail.conf (main domain) no setting as main domain users do not use suffixes 
dmail.conf (suffix vdomain) vdomain cc @computers.com computers.com c:\dmail\in\computers
(2nd item in vdomain line is suffix = '@computers.com',
NB: it includes separator character)
 
dmail.conf (IP vdomain) no setting as IP based virtual domain
users do not use suffixes
 
cwmail.inino setting as main domain users do not use suffixes 
cwmail.ini (suffix vdomain) suffix @computers.com
(includes separator chracter)
 
cwmail.ini (IP vdomain) no setting as IP based virtual domain
users do not use suffixes
 
netauth.ini (main domain)no setting 
netauth.ini (suffix vdomain)suffix @computers.com
(includes separator)
suffix computers.com
suffix_separator @
(pre version 4, e.g. 3.0e, use 2 setttings)
netauth.ini (IP vdomain)no setting  

Examples:

  1. Just one domain, authent_domain true:

    Login to DPOP with: test
    Login to CWMail with: test


    Name in user database: test@netwin.co.nz
    DSMTP authenticates: test@netwin.co.nz
    DPOP authenticates: test@netwin.co.nz

     dmail.confcwmail.ininetauth.inipre 2.7 dmail.conf pre version 4 NetAuth (3.0e)
    Settings:host_domain netwin.co.nz
    host_domain mail.netwin.co.nz
    authent_domain true
    pophost netwin.co.nz
    smtphost netwin.co.nz
    pophost netwin.co.nz
    domain netwin.co.nz
    dpop_host netwin.co.nz
    host_domain netwin.co.nz
    host_domain mail.netwin.co.nz
    authent_domain true
    domain netwin.co.nz
    domain_separator @
    Defaults being used:     
    Do NOT use these:dpop_host netwin.co.nz
    or
    dpop_host mail.netwin.co.nz
      prefix
    suffix
    domain_separator
    suffix_separator
    prefix_separator
       

  2. Example 1 with 1 suffix based virtual domain added
    (= main domain + 1 suffix vdomain + authent_domain true)

    2 users: test on netwin.co.nz and sales on computers.com

    Login to DPOP with: test and sales@computers.com from any ip address
    Login to CWMail at http://www.netwin.co.nz/scripts/cwmail.exe with: test
    Login to CWMail at http://www.computers.com/scripts/cwmail.exe with: sales

    Name in user database: test@netwin.co.nz and sales@computers.com
    DSMTP authenticates: test@netwin.co.nz and sales@computers.com
    DPOP authenticates: test@netwin.co.nz and sales@computers.com

     dmail.confcwmail.ininetauth.inipre 2.7 dmail.conf pre version 4 NetAuth (3.0e)
    Settings:host_domain netwin.co.nz
    host_domain mail.netwin.co.nz
    authent_domain true
    vdomain cc @computers.com computers.com c:\dmail\in\computers
    pophost netwin.co.nz
    smtphost netwin.co.nz
     
    vhost www.computers.com
    pophost computers.com
    smtphost computers.com
    suffix @computers.com
    vend
    pophost netwin.co.nz
    suffix netwin.co.nz
    suffix_separator @
     
    vhost www.computers.com
    pophost computers.com
    suffix @computers.com
    domain computers.com
    vend
    dpop_host netwin.co.nz
    host_domain netwin.co.nz
    host_domain mail.netwin.co.nz
    vdomain cc @computers.com computers.com c:\dmail\in\computers
    pophost netwin.co.nz
    suffix netwin.co.nz
    suffix_separator @
     
    vhost www.computers.com
    pophost computers.com
    suffix @computers.com
    domain computers.com
    domain_separator @
    vend
    Defaults being used:     
    Do NOT use these:dpop_host netwin.co.nz
    dpop_host mail.netwin.co.nz
    host_domain computers.com
     
    prefix
    prefix_separator
    domain_separator