### 	Syntax: 	###

# name#<display name>#NOCONF=cannot be configured via web/TRUE=don't check binary exists/FALSE=do check#<binary name(without .exe)>#<config file name>#operating system WIN32|UNIX|ALL#<URL>
# <List of settings
# <setting name>#<display name>#<default value>($SETTING_NAME$ allowed)#<set on cmd line>#<use checkbox>#<dont store blanks>#<description>
# ...
# >
# name#...
# NB: if command line and checkbox are both true then result is for example '-debug' rather than '-debug TRUE'
# NB: they will appear in reverse order

###################
###	NWAUTH	###
###################

name#NWAuth##nwauth##ALL#http://netwinsite.com/authent/

### 	Command Line Settings


log#Turn on Logging##TRUE#TRUE#FALSE#FALSE#Turns on logging to nwauth.log file (you must MANUALLY delete log file).

path#Database Path#$g_home$#TRUE##FALSE#FALSE#Path to user database files (DONT change this unless you are sure)

domain#Domain Append##TRUE#FALSE#FALSE#FALSE#Adds @domain onto end of all usernames added to nwauth database.(Obscure)
isfallback_unix_crypt#Fallback Unix Crypt##TRUE#TRUE#FALSE#FALSE#On NT, if true, nwauth will handle entries imported from a unix system password file.		(Obscure)
isfallback_unix#Fallback Unix##TRUE#TRUE#FALSE#FALSE#Turns on checking for users in unix system password file when they are not in nwauth file.NB: may require NetWin do to special build of nwauth binary for you.(Obscure)
readonly#Set Readonly#false#TRUE#TRUE#FALSE#FALSE#Don't allow new additions or modifying of users or their data.(Obscure)
allowats#Allow @ in Username##TRUE#TRUE#FALSE#FALSE#Allow @ symbol in usernames(Obscure)
nocrypt#Don't encrypt##TRUE#TRUE#FALSE#FALSE#Do not encrypt user passwords
showpass#Show password##TRUE#TRUE#FALSE#FALSE#Show the users password in the web admin interface (requires "Don't encrypt")
allowhighascii#Allow High ASCII in Username##TRUE#TRUE#FALSE#FALSE#Allow high and low ASCII characters in usernames, which would normally be not allowed.(Obscure)
badchar#Specifiy Illegal Characters##TRUE#FALSE#FALSE#FALSE#Overide the default illegal character list with your own list. Covers whole database.(Obscure)
badchar_localpart#Specifiy Illegal Characters in Username##TRUE#FALSE#FALSE#FALSE#Overide the default illegal character list with your own list. Covers usernames (anything before @ character) only.(Obscure)
drop_path#Auto Drop Paths##TRUE#FALSE#FALSE#FALSE#(enter &quot;&lt;hash_method&gt; &lt;base_path&gt;&quot; as value) makes nwauth generate drop file part of response in form &quot;&lt;base_path&gt;\hash_result\username&quot;,hash_method is pop server hashing type(hash=0,1,2). (Obscure)
logpass#Log Passwords##TRUE#TRUE#FALSE#FALSE#When logging, logs passwords in plain text.(Obscure)
size#Max Size nwauth.add##TRUE#FALSE#FALSE#FALSE#Allows adjustment of how often index is rebuilt.(Obscure)
sleep#Give slow responses##TRUE#FALSE#FALSE#FALSE#Testing: (enter &quot;x y&quot; as value) sleep for y seconds first and every xth response.

###	Settings not made available

# nwauth -set user password var1=value ...
# nwauth -mod user var1=value ...
# nwauth -del user
# nwauth -check user password
# nwauth -lookup user
# nwauth -search string
# nwauth -search string [-max n] (don't return more than n entries)
# nwauth -search string [-from n] (start returning from n'th
# 	matching entry)
# nwauth -readonly (use on slaves that don't need to update files)
# nwauth -encrypt user/all
# nwauth -generate n (creates accounters test0..testn passwords test)
# Don't know what this is: old_crypt#Old Crypt##TRUE#TRUE#Something to do with SSHA.(Obscure)
# Don't know what this is: nfs#NFS Locking##TRUE#TRUE#Something to do with nfs.(Obscure)
# -test_con
# -test
# -fix
# -version
# -makelist
# -dodrop
# -lock
# -debug enables messages to STDOUT which we don't want in surge, use -log instead
# 


###########################
###	ODBCAuth	###
###########################

name#ODBCAuth##odbcauth#odbcauth.ini#WIN32#http://netwinsite.com/authent/

### 	Ini Settings

database_driver#Database Driver#ODBCAuth#FALSE##FALSE#FALSE#This is the name of the ODBC data source.
database_user#Database Username##FALSE##FALSE#FALSE#This is the login username for the ODBC data source.
database_pass#Database Password##FALSE##FALSE#FALSE#This is the login password for the ODBC data source.
database_table#Table#maildb#FALSE##FALSE#FALSE#This is the table within the ODBC data source to use.
field_username#Field Containing Usernames#user#FALSE##FALSE#FALSE#This is the name of the field that contains the user's username.
field_password#Field Containing Passwords#pass#FALSE##FALSE#FALSE#This is the name of the field that contains the user's password.
field_domain#Field Containing Domain#domain#FALSE##FALSE#FALSE#This is the name of the field that contains the domain name part of the users name - leave blank if the field_username contains the domain name (recommended), or authent_domain FALSE is being used.

field_translate#Field Translate##FALSE##FALSE#FALSE#This setting allows you to translate field names, for example 'forward fwd' will cause the auth module to read the 'forward' field from the database and return it as 'fwd'.
domain#Domain Name##FALSE##FALSE#FALSE#The domain name, this is used if no domain name is specified in the authent request.
append_domain#Append domain#FALSE#FALSE#TRUE#FALSE#FALSE#Append the domain name to the username added/checked in the database.

check_crypt#Check Crypt#FALSE#FALSE#TRUE#FALSE#FALSE#This setting requests that odbcauth attempts to match the password as if it was crypt'ed.(Obscure)
select_extras#Select Extras##FALSE##FALSE#FALSE#This setting allows you to pass extra requirements on all select statements to the database.
use_sha#Use SHA#FALSE#FALSE#TRUE#FALSE#FALSE#This setting enables the use of ssha encrypted passwords.

loglevel#Log Level#info#FALSE##FALSE#FALSE#The amount of data to log, error,info,debug
ignore_unknown_fields#Ignore unknown fields#TRUE#FALSE#TRUE#FALSE#FALSE#Do not give errors if asked to set fields that do not exist in the database
temp_dir#Temp Dir##FALSE#FALSE#FALSE#FALSE#The path to create temporary files

### 	Command Line Settings   

path#Path#$g_home$#TRUE#FALSE#FALSE#FALSE#Specifies where to create its logfile and where to find its config file.
# -debug enables messages to STDOUT which we don't want in surge, use -log instead








###########################
###	Oracle Auth	###
###########################

name#OracleAuth##oracleauth#oracleauth.ini#ALL#http://netwinsite.com/authent/

### 	Ini settings

oracle_db#Oracle DataBase#users#FALSE##FALSE#FALSE#This is the name of the oracle database.
oracle_user#Oracle Username##FALSE##FALSE#FALSE#This is the login username for the oracle database.
oracle_pass#Oracle Password##FALSE##FALSE#FALSE#This is the login password for the oracle database.
oracle_table#Oracle Table#maildb#FALSE##FALSE#FALSE#This is the table within the oracle database to use.

field_user#Field Containing Usernames#username#FALSE##FALSE#FALSE#This is the name of the field that contains the user's username.
field_pass#Field Containing Passwords#password#FALSE##FALSE#FALSE#This is the name of the field that contains the user's password.
field_translate#Field Translate##FALSE##FALSE#FALSE#This setting allows you to translate field names, for example 'forward fwd' will cause oracleauth to read the 'forward' field from the database and return it as 'fwd'.

#debug#Debug#false#FALSE#TRUE#FALSE#If set to 'true' has same effect as 'loglevel debug'.
loglevel#Log Level#info#FALSE##FALSE#FALSE#The amount of data to log, error,info or debug.

### 	Command Line Settings          

path#Path#$g_home$#TRUE#FALSE#FALSE#FALSE#Specifies where to create its logfile and where to find its config file.
# -debug enables messages to STDOUT which we don't want in surge, use -log instead


###################
###	NTAuth	###
###################

name#NTAuth##ntauth#ntauth.ini#WIN32#http://netwinsite.com/authent/

### 	Ini settings

user_group#User Group#SET_THIS#FALSE##FALSE#FALSE#The name of the group that new users are added to. This group MUST have the &quot;logon as a batch job&quot; privilege.
user_workarea#User Workarea#\ntauth #FALSE##FALSE#FALSE#The base directory where user files are created, these files are created in hashed directories, one file per user.
loglevel#Log Level#info#FALSE##FALSE#FALSE#The amount of data to log, error,info or debug
debug#Debug#false#FALSE#TRUE#FALSE#FALSE#If set to 'true' has same effect as 'loglevel debug'.
controller#Domain Controller##FALSE##FALSE#FALSE#The domain controller where accounts are stored. Leave blank if account are on the local machine.
active_directory#Active Directory#false#FALSE#TRUE#FALSE#FALSE#Whether using an active directory domain controller or not.
nt_home_dir#Home directory field#home_dir#FALSE#FALSE#FALSE#FALSE#The field to return the NT users home directory as.
nt_comment#Comment field#comment#FALSE#FALSE#FALSE#FALSE#The field to return the NT users comment as.
nt_script_path#Script path field#script_path#FALSE#FALSE#FALSE#FALSE#The field to return the NT users script path as.
strip_prefix#Strip prefix#strip_prefix#FALSE#FALSE#FALSE#FALSE#A string to strip from the front of usernames
strip_suffix#Strip suffix#strip_suffix#FALSE#FALSE#FALSE#FALSE#A string to strip from the end of usernames

### 	Command Line Settings          

path#Path#$g_home$#TRUE#FALSE#FALSE#FALSE#Specifies where to create its logfile and where to find its config file.
# -debug enables messages to STDOUT which we don't want in surge, use -log instead


###########################
###	UNIXAuth	###
###########################

name#UNIXAuth##unixauth#unixauth.ini#UNIX#http://netwinsite.com/authent/

### 	Ini settings

user_group#User Group#&lt;UID&gt;#FALSE##FALSE#FALSE#The name of the group that new users are added to.  &lt;UID&gt; is a special case where a new group is created with the same name as the user and a group id equal to the user's uid if possible otherwise gid is set to highest available gid.
user_home#User Home#/home#FALSE##FALSE#FALSE#The base directory for user home directory creation, a home directory called the user's name (without any @domain.com, if present) is created in this directory for every new user.
user_baseid#User Base ID#100#FALSE##FALSE#FALSE#The lowest new user uid, UnixAuth will find the first available uid greater than all existing uid's and greater than this setting.
passwd_file#Password File#/etc/passwd#FALSE##FALSE#FALSE#Password file to modify.
shadow_file#Shadow File#/etc/shadow#FALSE##FALSE#FALSE#Shadow file to modify, if you have shadow passwords and have noshadow set to false.
group_file#Group File#/etc/group#FALSE##FALSE#FALSE#Group file to modify.
noshadow#Shadow Passwords Off##FALSE#TRUE#FALSE#FALSE#Turn shadow passwords off. Shadow password support is only present if the system supports it and if it does it may still be disabled with this setting.
group_char#Group Character#x#FALSE##FALSE#FALSE#The character used in the group file to indicate the group password is not stored here.(Default normally works)
passwd_char#Passwd Character#x#FALSE##FALSE#FALSE#The character used in the passwd file to indicate the users password is not stored here.(Default normally works)
lowerbound_uid#Lower Bound UID#0#FALSE##FALSE#FALSE#The lowest uid to return in a search, check, or lookup.
changes_process#Changes Process##FALSE##FALSE#FALSE#The process to execute after changing the password and/or shadow files.
changes_retries#Changes Retries#10#FALSE##FALSE#FALSE#This is the number of times to wait 100 millisecconds for the above process to finish. Eg. If you set this to 10 then unixauth will wait 1 seccond for the above process to finish.(Default normally works)
domain#Domain Name##FALSE##FALSE#FALSE#The domain name, if set this domain name is appended to all usernames returned by all the commands. It is NOT appended to usernames added to the database.
loglevel#Log Level#info#FALSE##FALSE#FALSE#The amount of data to log, error,info or debug
# debug#Debug#false#FALSE#TRUE#FALSE#FALSE#If set to 'true' has same effect as 'loglevel debug'.

### 	Command Line Settings          

path#Path#$g_home$#TRUE#FALSE#FALSE#FALSE#Specifies where to create its logfile and where to find its config file.
# -debug enables messages to STDOUT which we don't want in surge, use -log instead



###################
###	DNAuth	###
###################

name#DNAuth##dnauth##ALL#http://netwinsite.com/authent/

### 	Command Line Settings 

#debug#Debug##TRUE#TRUE#FALSE#FALSE#Set logging level to Debug. (Manually delete log file, as will append new log messages)
path#Path#$g_home$#TRUE#TRUE#FALSE#FALSE#Specifies path to find users.dat file (and to log to). Not normally used as DNAuth finds correct path from dnews.conf.
#-version
log#Logging##TRUE#TRUE#FALSE#FALSE#Turn on logging.(Manually delete log file, as new log messages will be appended to log file)
#-help


###################
###	TCPAuth	###
###################

name#TCPAuth##tcpauth##ALL#http://netwinsite.com/authent/

### 	Command Line Settings 

host#Host#127.0.0.1#TRUE##FALSE#FALSE#Specify IP address of machine running TCPAuth Server.  NB: You must install TCPAuth Server

#-help -h

debug#Debug##TRUE#TRUE#FALSE#FALSE#Set logging level to Debug.

#-version

dolog#Do Logging##TRUE#TRUE#FALSE#FALSE#Turn on logging.

#-secret



###########################
###	NiagaAuth	###
###########################

name#NiagaAuth#TRUE#FALSE#/usr/bin/perl /auth/niagaauth.pl##ALL#http://netwinsite.com/authent/
none###TRUE#FALSE#FALSE#No Settings: Change Values at top of niagaauth.pl file itself.  NB: you may need to manually edit path in authent_process setting in surgemail.ini.


###########################
###	LDAPAuth	###
###########################

name#LDAPAuth##ldapauth#ldapauth.ini#ALL#http://netwinsite.com/authent/

info_fields#Info Fields (pairs)####FALSE#TRUE#This field is used to match LDAP field entries with external program field names that are also delivered to and from the database. (Use commas to separate pairs, example: 'usergroups groups,description desc') 
must_set_fields#Must Set Fields (pairs)####FALSE#TRUE#This field is used make ldapauth setup variables which are required for the selected schemas)


## 	Command Line Settings   

path#Path#$g_home$#TRUE#FALSE#FALSE#Specifies where to create its logfile and where to find its config file.

###########################
###	MySQLAuth	###
###########################

name#MySQLAuth##mysqlauth#mysqlauth.ini#ALL#http://netwinsite.com/authent/

info_fields#Info Fields (pairs)####FALSE#TRUE#This field is used to match LDAP field entries with external program field names that are also delivered to and from the database. (Use commas to separate pairs, example: 'usergroups groups,description desc') 
must_set_fields#Must Set Fields (pairs)####FALSE#TRUE#This field is used make ldapauth setup variables which are required for the selected schemas)


### 	Command Line Settings   

path#Path#$g_home$#TRUE#FALSE#FALSE#Specifies where to create its logfile and where to find its config file.


###########################
###	RadiusAuth	###
###########################

name#RadiusAuth##radiusauth#radiusauth.ini#ALL#http://netwinsite.com/authent/

radius_host#Radius Host#localhost###FALSE#FALSE#This is the IP address or Name of the radius server.
radius_port#Radius Port#1812###FALSE#FALSE#This is the TCPIP port of the radius server (Normally 1812)


radius_secret#Radius Secret####FALSE#FALSE#This is the encryption_key that is setup on the radius server that the Mail server needs to use. 
radius_user_file#Radius User File#radius.dat###FALSE#FALSE#This is the file where usernames/passwords are stored so that lookups without passwords can be done. (Typically radius.dat)


field_username#Username Field#username###FALSE#FALSE#The label of the username field in your table. 
field_password#Password Field#passwd###FALSE#FALSE#The label of the password field in your table. 


radius_attribute#Radius Attribute####FALSE#FALSE#This is the radius attribute that is used that stores the fwd and quota settings. (string) 
field_forward#Forward Field#forward###FALSE#FALSE#The label of the forward field in your table. This is the forwarding information that DMail uses to determine what it forwards the EMail to. 
field_quota#Quota Field####FALSE#FALSE#The label of the quota field in your table. This is the disk quota the user has. e.g. 100k,  10M 
field_mailmask#Mail Mask Field####FALSE#FALSE#The label of the mailmask field in your table. This is the IP mask that SQLAuth checks against the &quot;from IP&quot; of the user. This forces the user to use only the specified IP. 
field_maildrop#Mail Drop Field####FALSE#FALSE#The label of the maildrop field in your table. This is the location where dmail will drop the user mail files. 

unix_password#UNIX Password###TRUE#FALSE#FALSE#Only designed to be used on UNIX machines. Tells the auth program to use the UNIX password system for storing passwords. 
plain_password#Plain Password###TRUE#FALSE#FALSE#Tells the auth program to save the passwords as clear text. (Obscure) 
lowercase_username#Lowercase Usernames###TRUE#FALSE#FALSE#This will convert all usernames to lowercase when comparing names. 
lowercase_username_set#Lowercase Usernames Set###TRUE#FALSE#FALSE#This will convert all names to lowercase before adding them to the database. 
search_min#Search Min####FALSE#FALSE#This is the minimum number of characters that any search routine must have before a search is performed. (Obscure)
domain#Domain####FALSE#FALSE#Specifies the domain that is attached when users are created in the database, e.g.     lynden     becomes:      lynden@&lt;domain&gt; 
log#Logging###TRUE#FALSE#FALSE#Enables verbose debug output.  


###################
###   Multiath  ###
###################

name#Multiauth#NOCONF#multiauth##ALL#http://netwinsite.com/authent/
