Technical information

191
SMTP Authentication
SMTP Authentication
Simple Mail Transfer Protocol (SMTP) is a protocol for sending email messages between servers. VSI-FAX supports
the authentication required by some mail servers to receive submitted email messages.
Note
Because of the specialized authentication MSN uses, it is not supported as an ISP.
The following parameters, which support the use of email authentication within VSI-FAX, can be set in
$VSIFAX/lib/vsisrv.ini file, [VMAIL]section.
auth-
type
The authentication type to use. This must match one of the types recognized by the SMTP server. When
you issue the EHLO SMTP command to the mail server, it will respond with the authentication types
available in the AUTH line.
auth-
rsp
The list of responses to use. This is an encrypted string consisting of a colon-delimited list of responses.
The vmail program will decrypt this entry and send each part as a response to an authentication prompt,
encoding the text in base64 as it sends it.
auth-
delim
An alternate delimiter to use in case any of the response strings contain a colon.
Configuring VSI-FAX for SMTP Authentication
To configure VSI-FAX for mail server authentication:
1. Determine the type of authentication used by your mail server:
2. Issue the telnet <mailserverIP> 25 command to connect to the SMTP port on the mail server.
3. Issue the EHLO command.
4. Check the AUTH line to see what authentication types are available.
5. Issue the QUIT command to disconnect from the mail server.
6. In $VSIFAX/lib/vsisrv.ini file, [VMAIL] section, add the auth-type=<authtype> linewhere
<authtype> is the type of authentication used by the mail server. For example, if the mail server is using
login authentication, you would add the following line:
auth-type=login
7. Add the response the mail server requires using the vfxadmin config command from a command prompt.
You will be prompted to enter the auth-rsp. You must enter <user>:<pswd> where <user> is the mail
user the way it appears in the $VSIFAX/lib/vsisrv.ini file and <pswd> is that user's password. You will
need to re-enter it. (The entries in the auth-rsp field are colon delimited and encrypted. Since the string is
encrypted, you must add it using the vfxadmin config command instead of entering it directly into the
vsisrv.ini file.) There should now be an encrypted password line in the [VMAIL] section of the vsisrv.ini
file. For example, if the auth-type was login, and a login name (test) and password (hello) were required, you
would execute the following steps:
8. Issue vfxadmin config -a -p -e VMAIL auth-rsp