Guides

Configuring the Email Notification Channel

Suggest Edits

In Data One, a System Email Notification Channel is configured by default with an SMTP Client Connection that requires a few parameters to finalize its configuration, as described in the following steps:

  1. Go to Setup → Notification Channels and edit the System Email Notification Channel entry in the result set.
  2. In the EDIT CHANNEL window, some fields are already filled in but you can change them according to your needs:
    1. Name: this field cannot be modified.
    2. Description: this field cannot be modified.
    3. Select Connection: this is the SMTP server that will be used to send emails. defaultSMTPClientConnection is selected but needs further configuration. In the drop-down list, click Show all to open the Manage Connections window where you must edit the defaultSMTPClientConnection clicking the pencil icon and adding these parameters:
      1. Authority Host: address of the SMTP server
      2. Authority Port: port of the SMTP server
      3. User Information: user identifier for SMTP connection
      4. User Password: password
      5. Authentication Protocol: SSL/TLS protocol to be used. Note that to correctly configure the connection for ICAP, you need to choose this value: TLSV1-2.
      6. Connection security: enables a secure connection. Note that to correctly configure the connection for ICAP, you need to choose this value: STARTTLS.
      In this window, the Add connection option is available on the top-right corner to create another connection. A complete description of all the parameters is available in the SMTP section of this user guide.
      Click the CONFIRM button when done.
    4. Select a Cluster: select the STENG cluster through which the SMPT server must be contacted.
    5. Select Template: this section has these tabs:
      1. DATA-WATCHER: in this tab you can configure the templates that will be used as body of the emails sent for these 4 DATA WATCHER events: cut-off error, cut-off warning, flow completed and flow error. If you want to configure a single template covering all events, use the Default Template option. If you do not want notifications to be sent, leave the event without template.
      2. ICAP: in this tab you can configure the templates that will be used as body of the emails sent for these 4 ICAP events: AV threat detected, DLP threat detected, server unavailable and file scan skipped.
      3. CENTRAL LOG: in this tab you can configure the templates that will be used as body of the emails sent for these 2 levels of log notifications: WARNING and ERROR. If you want to configure a single template covering all levels, use the Default Template option. If you do not want notifications to be sent, leave the event without a template.
      To associate a template, click the SELECT TEMPLATE button. In the Search and Select a Template window, select the template suiting your needs and then the SELECT button to confirm. If you need to load a new template, see the Loading a new template section in this manual.
  3. Click the SAVE button to confirm the options edited for the channel.


Capt. Eddie to ground control:


"Do you need to configure different email templates for different users? For example because Business users are not interested in the details of the errors of a flow, while these details are definitely useful for Admin users?
To set different email templates to be sent to different categories of users, you can define 2 notification channels and assign the proper templates to each of them. For example you can create:

  • Business Users Notification Channel with only the default template with mandatory Macros configured.
  • Admin Users Notification Channel with the default template and the four specific templates available with mandatory and non mandatory Macros.

Then, in DATA WATCHER you will just need to select the Business or Admin Channel and enter the actual Recipients."

Updated 4 months ago