Client Connection: SMTP πŸš€

Fields with the asterisk * are mandatory.

Properties
Description

NAME *

Name of the SMTP connection you are creating. The maximum number of characters is 128. Blanks and these special characters: ' " | are not supported.

DESCRIPTION

Description of the SMTP connection you are creating. The maximum number of characters is 2048.

STATUS

Enable or disable the client connection. Possible values:

  • Enabled (default value)

  • Disabled

HOST *

Remote host IP Address or hostname.

PORT *

Port to connect to the remote host (1 to 65535).

USERNAME *

Username to be used for the connection. The maximum number of characters is 320.

πŸš€ AUTHENTICATION TYPE *

Select the authentication type that will be used to connect to the SMTP server. Possible values:

  • BASIC (default)

  • OAUTH2_CLIENT_CREDENTIAL

PASSWORD *

Password of the user that will be used to connect to the SMTP server.

This field appears when BASIC is selected in the Authentication Type field.

πŸš€ SEARCH CREDENTIAL *

Select the credential that will be used in OAuth2 Authentication. The credentials listed in this drop-down menu are configured in Setup β†’ Credentials.

This field appears when OAUTH2_CLIENT_CREDENTIAL is selected in the Authentication Type field.

MATCH SERVER HOSTNAME

Possible values:

  • Enabled

  • Disabled (default value) When set to Enabled, the Client verifies that the Distinguished Name (DN) certificate contains the IP that has been contacted (i.e., the HOST value above).

CLIENT KEY LABEL

Key identifier to create the SSL connection

SSL AUTHENTICATION PROTOCOL

Select the SSL authentication protocol:

  • ALL

  • ONLY SPECIFIC VALUES:

    • SSLv3

    • TLSv1

    • TLSv1_1

    • TLSv1_2

    • TLSv1_3

    • SSLv2Hello

ACCEPTED CIPHER SUITES

Select the cipher suites. Possible values:

SIGN KEY ALIAS

Select a key to sign the emails.

CONNECTION SECURITY

Enable a secure connection:

  • STARTTLS

  • SSL_TLS

  • NONE

MAX RETRIES

Maximum number of retries. If this field is empty or set to 0, no retries will be executed and the job will be set to Failed if the first attempt is not successful. A high value corresponds to a high number of retrying attempts.

RETRY INTERVAL

This field will appear only if you have set the maximum numbers of retries to 1 or greater. Time (in seconds) waited before retrying executing a job. The lower the value, the more frequent the retrying attempts. If this field is empty or set to 0, no retries will be executed and the job will be set to Failed if the first attempt is not successful.

CONFIGURATION TEST

Use this section to test that the Cluster and the STENG are connected correctly. Select a Cluster and a STENG you want to test and click the TEST button. Data One automatically selects a Cluster and a STENG to test the connection. Note that a Cluster will be selected only if it is the only one available. A message with a green check will confirm a successful connection. A message with a red exclamation mark will warn about an unsuccessful connection. The message also details the reason why the connection fails. The connection might not be successful for different reasons, each of them depending on the transport type and the configuration. The first time you try to test the connection, if trusting certificates are missing, an error message detailing the unsuccessful connection will appear. In this case, go to Setup β†’ Untrusted Cache β†’ Certificates tab and trust the relevant certificates. Note that trusting certificates in the Untrusted Cache page may not be sufficient to establish a successful connection. Refer to the Untrusted Cache section of this documentation for all the details.

Last updated