First activate either a trading partner specific host or the generic SMTP or SMTP/s pre-configured host (see below). The generic SMTP host provides an interface over non-secure SMTP. If interfacing to a server that requires use of the Secure Socket Layer (SSL) SMTP, then the generic SMTP/s host must be used.
1. Click the Preconfigured tab in the 
tree pane.
2. Right-click the desired 
host.
3. Select 'Clone and Activate'. The entire pre-configured host branch will be copied and made
active, the 
Active
tab will be
automatically selected in the tree pane, and the new active host will be automatically selected in
the tree. The new active host alias may
be appended with a number, if necessary to make it unique. The original pre-configured host will remain
in the pre-configured tree.
4. If desired, type a new host alias in the 
content pane panel and click [Apply].
Now
configure the host tree (see below sections), starting with the host, then a 
mailbox, and finally an 
action.
NOTE: The configuration panels pictured below show an interface to a fictitious SMTP server, but serve as a good example because they include the possible syntax variations.
A host's parameters specify its location and how it is reached.
SMTP Host: General Tab
The following describes the General tab.
The Server
Address should be a fully qualified name. If it must be an IP address then it must be
enclosed in brackets (e.g. [128.92.88.204]).
A special "open-ended" SMTP host can be identified by an asterisk (*) in the Server Address. One "open-ended" SMTP host can be used to send to different SMTP servers at run-time (see SMTP Mailbox: SMTP Tab). "Open-ended" SMTP hosts are limited to sending; they can not request DSNs to be returned and they can not receive incoming payload emails.
The Port specifies the SMTP command port and can be
either a specific port # or
1 to indicate the default port for SMTP (25) or SMTP/s (465).
If
necessary, modify the Connection Type, Forward
Proxy,
and/or Phonebook Entry (refer to Configure System
Options , Configure for a Proxy, and/or Setup a VersaLex
Dial-up Connection).
Note: If the host is has an external association, the default directories may be managed outside of VersaLex and not shown here.
Modify the default directories, if
necessary. Macro variables may be
selected from the drop-down lists. Refer to Using Macro Variables for a list of the applicable
macros (Default Host Directory context) and example usage. Refer to the General tab under Configure System Options for
information regarding the setup of system-level directories and custom
directory macro variables.
SMTP Host: SMTP Tab
The following describes how to configure the host SMTP tab.
The Store raw sent checkbox can be used
to save the contents of the raw MIME payload messages sent to the remote
host. The files are stored in the
SMTP\sent directory under the VersaLex root path. These files may be useful in diagnosing
problems, but should be disabled if disk space needs to be conserved.
If
the SMTP server requires use of the Secure Socket Layer (SSL), select one of
two different Security Modes.
None
indicates non-secure transfers; commands and data are clear-text.
Some
servers support only SSL connections, in which case SSL Implicit should be selected.
Other
servers support SSL by use of the STARTTLS command.
With these types of servers, use SSL STARTTLS for secure
transfers.
Acceptable additional incoming sender subdomains
can be specified if incoming emails from this trading partner potentially come
from subdomains within the Server
Address on the General tab. A subdomain can be wildcarded with asterisks
(*) or question marks (?) (e.g. *.cleo.com) and multiple subdomains can be
separated by semi-colons (;) or commas (,) or entered on separate lines (e.g.
mailsvr01.lan.cleo.com;mailsvr02.lan.cleo.com). (VLTrader only)
SMTP Host: Advanced Tab
Refer to Set Advanced Host Properties for a description of how to use and set the properties which are supported in all protocols. Additional, available properties which are specific to SMTP or SMTP/s include:
|
Property |
Description |
Possible Values |
Default Value |
|
Always Send Multipart Messages |
Indicates to always send a multipart MIME message to the trading partner, even when there is only one attachment in the message. |
|
|
|
Data Termination Timeout |
The amount of time allowed for reply from server after sending DATA or last BDAT command. |
-1-600 seconds (-1 indicates to use Connection Timeout value) (0 indicates no timeout). |
-1 |
|
Do Not Send Zero Length Files |
Indicates whether files to be sent to the SMTP server which are zero length should be ignored rather than processed.
If the -DEL option is being used, any zero length file ignored will also be deleted. |
|
|
|
Ignore Exception After Quit |
Indicates to ignore any I/O errors that occur when attempting to read the SMTP server response after issuing a QUIT command. |
|
|
|
Include Date In Duplicate Message ID Check |
Some email clients do not generate a unique Message-ID in the email content. Including the message Date in the duplicate checker helps to avoid accidentally discarding messages that are not duplicates. (VLTrader only) |
|
|
|
SSL Allow Legacy Renegotiation |
When selected, legacy renegotiation will be allowed. If this property is not selected, the extension described in RFC5746 will be used for renegotiation and the server must also support this extension. Refer to RFC5746 for a description of the extension and the vulnerability it addresses. |
|
|
|
SSL Cipher |
Indicates a specific cipher to be used with the server for SSL key exchange, encryption, and hashing. If not set, the list of supported ciphers is presented to the server and the server picks one. |
Any cipher from the supported list. If the server does not also support the cipher, an SSL handshake error will occur. |
|
|
SSL Maximum Protocol Version |
Specifies the maximum protocol version which will be allowed for all listening secure server ports (HTTP, OFTP, and, for VLTrader, FTP and SMTP). By default, this field is blank designating that VersaLex will select the most recent version (currently TLS 1.1). |
‘SSL 3.0’ ‘TLS 1.0 (SSL 3.1)’ ‘TLS 1.1 (SSL 3.2)’ |
|
|
SSL Minimum Encryption Key Size |
Specifies the minimum encryption key size which will be allowed when selecting a SSL cipher. To prevent use of low or medium strength ciphers change from the default value of zero to 112 or 128 (depending on the requirement). |
0-n bits |
0 |
|
SSL Minimum Protocol Version |
Specifies the minimum protocol version which will be allowed. SSL 3.0 is the default value for compatibility with servers which do not support the more recent TLS versions 1.0 and 1.1. |
‘SSL 3.0’ ‘TLS 1.0 (SSL 3.1)’ ‘TLS 1.1 (SSL 3.2)’ |
‘SSL 3.0’ |
|
Use Put From As SMTP Mail From |
Indicates to use the generated email's MIME From: value also as the SMTP MAIL command's From: value (instead of the configured SMTP service username and domain). This may be necessary when the recipient's mail server expects the two to match. If the From: value is not where bounced messages should be returned, then a Return-Path: should also be specified. |
|
|
A
mailbox's parameters allow you access to the host system. Create a new mailbox under the host.
1. Right-click the host in the active tree pane.
2. Select 'New Mailbox' to
create a new lower branch. Then, if
desired, type a new alias in the content pane panel and click [Apply].
SMTP Mailbox: SMTP Tab
The following describes how to configure the mailbox SMTP tab.
Specify default values for sending (PUT
command):
Enter your trading partner's To email
username and optionally enter a Cc
(carbon copy) and/or a Bcc (blind
carbon copy) username. Multiple To, Cc
or Bcc usernames can be specified separated by semi-colons (;) or commas (,).
If this is an "open-ended" SMTP host (see SMTP Host: General Tab), then each To, Cc and Bcc specified must include the @domain portion of the email address.
Optionally enter a message Subject.
Optionally enter a From email address (user@domain), which will override VLTrader's
email address specified in the 
Local Listener SMTP 
service.
Optionally enter a Return-Path email address (user@domain), which will override
VLTrader's return-path address specified in the Local Listener SMTP service.
Optionally enter Inline text or select an .InlineFile
containing the "inline" portion of the message (non-attachment).
Optionally specify the default payload Content-Type. Select either from the provided pulldown list
or enter a value. If Content-Type is not
specified or if multiple payloads are attached in the message, the Content-Type
is detected based first on file content and then file extension. Detectable types include:
application/edifact, application/edi-x12, application/edi-tradacoms, application/xml (text/xml), application/pdf, application/msword, application/x-msexcel, application/rtf, application/zip, image/bmp, image/gif, image/tiff, image/jpeg, text/plain, text/html, and video/mpg
Optionally specify the default Content-Transfer-Encoding. Select '7bit', '8bit', 'quoted-printable',
'base64', 'uuencode', or 'binary' from the pulldown list. If not explicitly specified,
Content-Transfer-Encoding will be:
- 7bit for text/* content-types
- base64 for binary content-types if the server does not support the chunking extension
- binary for binary content-types if the server supports the chunking extension
Acceptable
additional incoming sender usernames can be specified if incoming emails
from this trading partner potentially come from usernames other than the To
username(s) specified above. Multiple
additional incoming sender usernames can be separated by semi-colons (;) or
commas (,) or entered on separate lines. (VLTrader
only)
SMTP Mailbox: DSN Tab
Note: This tab applies to VLTrader users only
The following describes how to configure the mailbox DSN tab.
A Delivery Status Notification is a form of receipt. If Return a DSN on success or failure is checked, VersaLex will request a Delivery Status Notification for each To recipient of a message (Cc and Bcc recipients are not included). Return message headers only or Return entire message indicates whether the returned DSN should include just the original message's outer headers or the entire original message. Also return a DSN on delay requests that an intermediate DSN also be returned when a message's delivery has been delayed for an unusually long period of time.
Possible received Delivery Status Notification action (status) values:
'delivered' - message delivery has succeeded. No further DSNs are expected.
'failed' - message delivery has failed. No further DSNs are expected.
'relayed' - message has been relayed or gatewayed into an environment that does not support DSNs. No further DSNs are expected.
'delayed' - message delivery is delayed. Further DSNs are expected.
'expanded' - message delivery has expanded to multiple recipient addresses. Further DSNs are expected.
Requested DSNs are returned back to VersaLex in a separate SMTP session. When a DSN has been requested as part of a sent message, VersaLex retains the original message and tracks message delivery based on the SMTP properties in the Local Listener: Advanced Tab.
Message delivery status and received DSNs can be viewed in the Local Listener SMTP Service: DSNs Tab.
NOTE:
- Not all SMTP servers support or honor DSN requests.
- DSNs are not non-reputable because they are not signed.
- The entire original message is only supposed to be returned in the DSN on failure and only when requested. Some SMTP servers always return the entire original message in the DSN regardless of failure status and regardless of whether only message headers were requested.
- If the entire original message is included in a DSN received by VersaLex, VersaLex will strip the payload out of the DSN while saving the DSN to the received/ folder. (The VersaLex sentbox can instead be used to permanently save sent payload.)
- Since the VersaLex SMTP server only acts as a mail endpoint, VersaLex only generates 'delivered' DSNs.
SMTP Mailbox: Content Tab
The following describes how to configure the mailbox Content tab.
Check Override SMTP Service if you wish to override the default media types specified in the Local Listener SMTP Service: Content Tab. Acceptable inbound (VLTrader only) and outbound media types can then be specified for this mailbox. A media type can be wildcarded with asterisks (*) or question marks (?). Multiple media types can be separated by semi-colons (;) or commas (,) or entered on separate lines. Example values include:
* = any payload media types acceptable
*/xml = all payload media types with subtype 'xml' acceptable
text/*;image/* = all payload media types with content-type 'text' or 'image' acceptable
application/edi* = all payload media types with content-type 'application' and subtype starting with 'edi' acceptable
Separate values for outbound versus inbound can be specified by clicking off Same as inbound. (VLTrader only)
SMTP Mailbox: Authenticate Tab
The following describes how to configure the mailbox Authenticate tab.
If the target server requires SMTP AUTH authentication, select the appropriate
type and provide the required username and password.
SMTP Mailbox: Security Tab
The following describes how to configure the mailbox Security tab.
If SSL STARTTLS or SSL
Implicit is specified in the host SMTP tab, the target server may issue
client certificates. If so, import the
client certificate using Certificate Manager and then specify (or browse for) the imported Certificate Alias
and Password.
SMTP Mailbox: Packaging Tab
Refer to Configure the Mailbox Packaging Tab for information regarding packaging of payload files.
An
action's parameters capture a repeatable transaction for your mailbox on the
host system. Create a new action under the mailbox.
1. Right-click the mailbox under the host in the active tree pane.
2. Select 'New Action,' to create a new lower branch. Then, if desired, type a new alias in the content pane panel and click [Apply].
SMTP Action: Commands Tab
The following describes how to configure commands within an Action.
Refer to Compose an Action. Also refer to the Command Reference below.