Configuring the default Email Notification Channel

PreviousWhat are Notification Channels NextConfiguring a new Email Notification Channel

Last updated 7 days ago

Configuring the default Email Notification Channel

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:

Go to Setup → Notification Channels and edit the System Email Notification Channel entry in the result set.
In the EDIT CHANNEL page, 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. Host: address of the SMTP server.
  2. Port: port of the SMTP server.
  3. Username: user identifier for the SMTP connection. Note: It can be overwritten by the notif-chan-mail-from setting, described on the page.
  4. Password: password.
  5. Match server hostname: enable this toggle switch if the DN certificate must contain the same IP as the HOST.
  6. Client KeyLabel: enter the key identifier to create the SSL connection.
  7. SSL authentication protocol: enables a secure connection. Select All or Only specific Values. Note that to correctly configure the connection for ICAP, you need to choose this value: STARTTLS.
  8. Accepted cipher suites: select All or Only specific Values.
  9. Sign key alias
  10. Connection security
  11. Max retries: enter the maximum number of reconnection attempts.
  12. Configuration test: select the cluster where you want to test your configuration.
4. Click the Confirm button, select the connection, and click the Select button to go back to the New Channel window.
5. Select cluster: select a different cluster or leave the cluster selected.
6. Select template: select a template for the email that will be sent following events occurring during the flow:
  1. Data Watcher: in this tab, you can configure the templates that will be used as the body of the emails sent for cut-offs ended with an error, cut-off warning (when the cut-off is about to expire), flow completed successfully, and flow in error.
  2. SYSTEM: use this tab to configure the template for the Password reset management. Note that the SYSTEM tab appears only in the defaultSMTPClientConnection channel.
  3. CONTRACT: in this tab, you can configure the template that will be used in the emails sent for generic local actions triggered by the EVENT NOTIFICATION service task.
  4. ICAP: in this tab you can configure the templates that will be used as the body of the emails sent for these 4 ICAP events: AV breach detected, DLP breach detected, server unavailable and file scan skipped.
  5. CENTRAL LOG: in this tab, you can configure the templates that will be used as the body of the emails sent for INFO, WARNING, and ERROR log notifications. 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, select it in the list. If you need to load a new template, see the section in this manual.
7. Click the SAVE button to confirm the options edited for the channel.

You may 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:

a Business Users Notification Channel with only the default template with mandatory Macros configured.
an 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.

PreviousWhat are Notification Channels NextConfiguring a new Email Notification Channel

Last updated 7 days ago

Go to Setup → Notification Channels and edit the System Email Notification Channel entry in the result set.
In the EDIT CHANNEL page, 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. Host: address of the SMTP server.
  2. Port: port of the SMTP server.
  3. Username: user identifier for the SMTP connection. Note: It can be overwritten by the notif-chan-mail-from setting, described on the page.
  4. Password: password.
  5. Match server hostname: enable this toggle switch if the DN certificate must contain the same IP as the HOST.
  6. Client KeyLabel: enter the key identifier to create the SSL connection.
  7. SSL authentication protocol: enables a secure connection. Select All or Only specific Values. Note that to correctly configure the connection for ICAP, you need to choose this value: STARTTLS.
  8. Accepted cipher suites: select All or Only specific Values.
  9. Sign key alias
  10. Connection security
  11. Max retries: enter the maximum number of reconnection attempts.
  12. Configuration test: select the cluster where you want to test your configuration.
4. Click the Confirm button, select the connection, and click the Select button to go back to the New Channel window.
5. Select cluster: select a different cluster or leave the cluster selected.
6. Select template: select a template for the email that will be sent following events occurring during the flow:
  1. Data Watcher: in this tab, you can configure the templates that will be used as the body of the emails sent for cut-offs ended with an error, cut-off warning (when the cut-off is about to expire), flow completed successfully, and flow in error.
  2. SYSTEM: use this tab to configure the template for the Password reset management. Note that the SYSTEM tab appears only in the defaultSMTPClientConnection channel.
  3. CONTRACT: in this tab, you can configure the template that will be used in the emails sent for generic local actions triggered by the EVENT NOTIFICATION service task.
  4. ICAP: in this tab you can configure the templates that will be used as the body of the emails sent for these 4 ICAP events: AV breach detected, DLP breach detected, server unavailable and file scan skipped.
  5. CENTRAL LOG: in this tab, you can configure the templates that will be used as the body of the emails sent for INFO, WARNING, and ERROR log notifications. 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, select it in the list. If you need to load a new template, see the section in this manual.
7. Click the SAVE button to confirm the options edited for the channel.

a Business Users Notification Channel with only the default template with mandatory Macros configured.
an 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.