Guides

Client Connection: POP3 IMAP

Suggest Edits

Fields with the asterisk * are mandatory.

PropertiesDescription
NAME *Name of the POP3 IMAP connection you are creating. The maximum number of characters is 128. Blanks and these special characters: ' " | are not supported.
DESCRIPTIONDescription of the POP3 IMAP connection you are creating. The maximum number of characters is 2048.
STATUSEnable 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.
    PASSWORD *User password.
    MATCH SERVER HOSTNAMEPossible 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 LABELKey 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 SUITESSelect the cipher suites.
    ALL or specific values in the drop-down list (See ACCEPTED CIPHER SUITES):
  • ALL
  • ONLY SPECIFIC VALUES
    • STORE TYPE
  • IMAP (default): Get email but leave a copy on the server
  • POP3 Get email and delete it on the server
    • FOLDER * Folder where the email will be saved.
    CONNECTION SECURITY Enable a secure connection:
  • STARTTLS
  • SSL_TLS
  • NONE
    • DISPOSITION Action to do after polling:
  • DELETE
  • KEEP
  • SEEN
    • PULL DISPOSITION Email to get:
  • GET_FIRST_MESSAGE
  • GET_FIRST_UNREAD_MESSAGE
  • GET_LAST_MESSAGE
  • GET_LAST_UNREAD_MESSAGE

    • NOTE: “first message” means the oldest.
    MAX RETRIESMaximum 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 guide for all the details.

    Updated 7 months ago