Versions Compared

Version Old Version 3 New Version 4
Changes made by

Chandresh Patel

Chandresh Patel

Saved on

Key

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

The Email Settings connect FlexDeploy to your email server, allowing for outbound event outgoing email notifications and, if enabled, inbound incoming reply processing for approval responses.

...

Property

Description

Default Values

SMTP Host Name

Host name of the SMTP server for event notifications.

mail.domain.com

SMTP Host Port

Host port of the SMTP server for event notifications.

25

SMTP Auth Type

Authentication method to use for SMTP, defaults to Basic Auth. Select OAuth if you would like to use OAuth with Microsoft Office 365.

Basic Auth

SMTP User

SMTP Authentication user

SMTP Password

The SMTP User's password, not applicable when using OAuth.

SMTP OAuth Application

The OAuth application that was setup on the System Settings - Integrations page for email purposes. Only applicable when using OAuth.

SMTP From Address

Address from which all outbound emails are sent

noreply@domain.com

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

true

SMTP Properties

SMTP Server Properties. These are all the properties applied when connecting to your mail server. Depending on your mail server you may need to add more properties than the default below. With this field you have access to the follow variables to use in the SMTP Properties:

  • PROTOCOL - Set the value of protocol in your SMTP Properties and the value will replace all occurrences of ${{PROTOCOL}} in the SMTP Properties. Examples of protocol could be "smtp".

  • SMTP_HOST_NAME - Use the ${{SMTP_HOST_NAME}} syntax and the plaintext will get replaced with the value of the above SMTP Host Name field at runtime.

  • SMTP_HOST_PORT - Use the ${{SMTP_HOST_PORT}} syntax and the plaintext will get replaced with the value of the above SMTP Host Port field at runtime.

  • SMTP_ENABLE_TLS - Use the ${{SMTP_ENABLE_TLS}} syntax and the plaintext will get replaced with the value of the above SMTP Enable STARTTLS field at runtime.

Default SMTP Properties
Code Block
PROTOCOL=smtp
mail.${{PROTOCOL}}.host=${{SMTP_HOST_NAME}}
mail.${{PROTOCOL}}.port=${{SMTP_HOST_PORT}}
mail.${{PROTOCOL}}.starttls.enable=${{SMTP_ENABLE_TLS}}
mail.${{PROTOCOL}}.connectiontimeout=30000
mail.${{PROTOCOL}}.timeout=30000
mail.${{PROTOCOL}}.writetimeout=30000
mail.${{PROTOCOL}}.class=com.sun.mail.smtp.SMTPTransport
mail.${{PROTOCOL}}.ssl.protocols=TLSv1.2

PROTOCOL=smtp

Enable Email Approval

Enable approvals by email reply. Requires additional IMAP related configurations to read email replies.

false

IMAP Host Name

Host name of the IMAP server for inbound email processing.  Required if email approvals are enabled.

imap.domain.com

IMAP Host Port

Host port of the IMAP server for inbound email processing.  Required if email approvals are enabled.

993

IMAP Auth Type

Authentication method to use for IMAP, defaults to Basic Auth.

Basic Auth

IMAP User

IMAP Authentication user. Defaults to the SMTP User.

IMAP Password

The IMAP User's Password. Defaults to the SMTP Password. Not applicable when using OAuth.

IMAP OAuth Application

The OAuth application that was setup on the System Settings - Integrations page for email purposes. Only applicable when using OAuth.

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

false

IMAP Properties

IMAP Server Properties. These are all the properties applied when connecting to your mail server. Depending on your mail server you may need to add more properties than the default below. With this field you have access to the follow variables to use in the IMAP Properties:

  • PROTOCOL - Set the value of protocol in your IMAP Properties and the value will replace all occurrences of ${{PROTOCOL}} in the IMAP Properties. Examples of protocol could be "imap" or "imaps".

  • IMAP_HOST_NAME - Use the ${{IMAP_HOST_NAME}} syntax and the plaintext will get replaced with the value of the above IMAP Host Name field at runtime.

  • IMAP_HOST_PORT - Use the ${{IMAP_HOST_PORT}} syntax and the plaintext will get replaced with the value of the above IMAP Host Port field at runtime.

  • IMAP_ENABLE_STARTTLS - Use the ${{IMAP_ENABLE_STARTTLS}} syntax and the plaintext will get replaced with the value of the above IMAP Enable STARTTLS field at runtime.

Default IMAP Properties
Code Block
languagetext
PROTOCOL=imap
mail.${{PROTOCOL}}.host=${{IMAP_HOST_NAME}}
mail.${{PROTOCOL}}.port=${{IMAP_HOST_PORT}}
mail.${{PROTOCOL}}.socketFactory.class=javax.net.ssl.SSLSocketFactory
mail.${{PROTOCOL}}.starttls.enable=${{IMAP_ENABLE_STARTTLS}}
mail.${{PROTOCOL}}.socketFactory.port=${{IMAP_HOST_PORT}}
#mail.${{PROTOCOL}}.socketFactory.fallback=false
#mail.${{PROTOCOL}}.ssl.enable=true
#mail.${{PROTOCOL}}.connectiontimeout=5000
#mail.${{PROTOCOL}}.timeout=5000

PROTOCOL=imap

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

Warning

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.

INBOX

Approval Reply Address

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

Tip

Important

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 Interval

Frequency in which FlexDeploy processes inbound messages from the Email .  Required if email approvals are enabled.  Default value is 5 minutes.

5

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.

30

Attach Logs

Whether 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".

Never

...