Mail

The Mail page can be reached by an Administrator via the Mail section in the System tab.

If you would like 1Data Gateway to send emails to users, the templates will need to be configured.

ClosedSender Settings

The Sender Settings tab.

  1. Select Enabled and fill the following settings with your mail server credentials:

    Parameter

    Description

    Expected Value

    From address

    The name and email messages are to be sent from.

    Email address

    Protocol

    Select whether the server is SMTP or SMTPS.

    SMTP/SMTPS

    Host name

    The host for the mail server.

    URI

    Port

    The port number through which the mail server is accessible.

    Integer

    Security

    Select the level of security associated with your mail server.

          Note: For security purposes it is recommended you use TLS when configuring your mail server.

    None / TLS / TLS Optional

    Username

    The username associated with your mail server.

    String

    Password

    The password associated with your mail server.

    String

  2. Select Test Connection to ensure the connection has been correctly established and select Save Settings to complete the configuration.

    3.      Note: If the connection fails and the error logs relate to TLS negotiation then it may be caused by TLSv1 and TLSv1.1 being deprecated in recent versions of Java.

    There are two solutions:

    1. Upgrade or reconfigure your mail server to use TLSv1.2. (Strongly recommended)

    2. If that is not possible: edit the java.security file and re-add TLS1 and TLSv1.1 to the jdk.tls.disabledAlgorithms property. Then restart the 1Data Gateway service for this to take effect.

ClosedMail Templates

     Note: You must be a System Administrator to configure Mail Templates.

Mail Templates tab showing the four template options.

There are four email types that can be configured:

  • Account Activation (Not available to LDAP users)

    • The email sent when a user account has been created and requires activation.

  • Request Password Reset (Not available to LDAP users)

    • Email to send when a user requests to reset their password.

  • Welcome - Registration complete

    • When a user account has been registered this email is sent to the new User. This is sent after both manual and automatic account activation.

  • Notification

    • Email to notify the progress of a submission when requested.

The tool gives you the option to edit the subject and the body of the email, along with other formatting options. The code can be formatted to be more readable by clicking the Format button or pressing "Shift+Alt+F".

An example of the notification email configuration.

     Note: The Add Field button allows you to select a Site name, User name or User email variable. User name and User email will be extracted from the user to whom the email is sent, whilst the Site Name used is the name set in Site Settings.