Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Email Communications system settings link links FlexDeploy to your email server to enable outbound event notifications, and optional inbound reply processing for approval responses.

Image RemovedImage Added

PropertyDescription
SMTP Host Name

Host name of the SMTP server for event notifications.

SMTP Host Port

Host port of the SMTP server for event notifications.

SMTP UserSMTP Authentication user
SMTP PasswordThe SMTP User's password
SMTP From AddressAddress from which all outbound emails are sent
SMTP Enable STARTTLS

Enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection before issuing any login commands.

Reference - https://kunder.support/knowledgebase/400/SSL-vs-TLS-vs-STARTTLS.html

Enable Email Approval

Enable approvals by email reply. Requires IMAP host name/port and user/password

IMAP Host NameHost name of the IMAP server for inbound email processing.  Required if email approvals are enabled.
IMAP Host PortHost port of the IMAP server for inbound email processing.  Required if email approvals are enabled.
Enable TLS

Identifies if the communication channel requires Transport Layer Security (TLS).

Email From AddressOutbound email address for sending event notifications.Email UserUser for the SMTP/IMAP server authentication.Email Password

Password for the SMTP/IMAP server user authentication.

Enable Email Approval

Enable users to reply with response for approval event notifications.

Tip
titleImportant
The emails are read and processed from the Email User, which must be a dedicated inbox and not used for any other purpose.   All emails from this inbox will be deleted after processing.
IMAP UserIMAP Authentication user. Defaults to the SMTP User.
IMAP PasswordThe IMAP User's Password. Defaults to the SMTP Password.
IMAP Enable STARTTLS

Enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection before issuing any login commands.

Reference - https://kunder.support/knowledgebase/400/SSL-vs-TLS-vs-STARTTLS.html

Email Reply Folder

The email folder to process replies from. Defaults to INBOX if not specified.  All inbound emails will be sent to default inbox folder, but rules can generally be configured on mail servers to move them to other folders if desired.

Warning
titleWarning

All emails from the this folder will be deleted after processing.  Do not use an email account which is used for any other purpose since the emails will be deleted.


Approval Reply Address

Return address for approval replies. Defaults to the SMTP From Address.

Tip
titleImportant

The emails are read and processed from this account, which must be a dedicated inbox and not used for any other purpose.   All emails from the Reply Email Folder in this account will be deleted after processing.  The connection is established to the mail server using the IMAP settings, and therefore, the IMAP user and the Approval Reply address must be linked.  It is possible to utilize an email group/distribution as the reply address, provided the IMAP User is a member of that group.


Email Reply Process IntervalFrequency in which FlexDeploy processes inbound messages from the Email
From Address INBOX
.  Required if email approvals are enabled.  Default value is 5 minutes
.  Any change requires a restart of the FlexDeploy server for changes to take effect
.
Email Reply Process Count

Number of email messages which are read and processed each interval.  The limit prevents Spam or DoS attacks from impacting the performance of the FlexDeploy server.  Required if email approvals are enabled.  Default value is 30 messages.

Attach LogsWhether or not to attach logs to the notification email for Request Completed and Request Failed events. If set to Never no logs will be attached (this is the default option). If set to Always all execution logs will be attached. If set to On Failure only the log(s) where the failure occurred will be attached. If only 1 log is present, just that log file will be attached it will be named "<InstanceName>_<StepNumber>_<StepName>_<EndPoint>(<PluginExecutionId>).log". If multiple are present they will be put into a zip folder and attached that way. The logs will be named "<StepNumber>_<StepName>_<EndPoint>(<PluginExecutionId>).log". The zip file will be named "<InstanceName>_logs.zip".


Info

Once the configuration is complete, you can click test the configuration by clicking on the Send Test Email button to send a test email Configuration button.

Don't know if we would actually want to display this, but just in case:

Google's SMTP Server Settings: https://support.google.com/mail/answer/7104828?hl=en
  • Send a test email to the logged in user's email address to validate the SMTP related settings.
HTML Comment
hiddentrue
  • Reads the inbox of the Approval Reply Address to validate the IMAP related settings.