Configuring Notifications

Learn how to set up an SMTP server and configure notifications.


Overview

In the Notifications settings, you configure DryvIQ’s global email notification infrastructure by defining your SMTP server details and verifying the connection; this establishes how alerts are delivered. Once the SMTP server is enabled, you can use the Add Email Recipient functionality to register recipients and assign them specific alert categories to receive. This ensures that designated teams or stakeholders are notified about relevant events across the platform.

Configuring the SMTP Server

Configuring the SMTP server determines the mail server and account that will generate the global email notifications. Once you add the information, you can test the connection to ensure no additional settings are needed. DryvIQ uses MailKit, which includes a default server certificate validation for a list of commonly used mail servers such as gmail.com, outlook.com, mail.me.com, yahoo.com, and gmx.net.

SSL Certificat Requirements

Notifications cannot be set up on an SMTP server with an untrusted SSL certificate. The environment where DryvIQ is running needs to trust the certificate. This can be done by manually trusting the certificate or using a valid self-signed certificate.

 
  1. Click Settings in the left menu.
  2. Click Notifications.
  3. You will see a red circle and text that reads, “SMTP server is disabled.” This indicates an SMTP server has not been set up. If the circle is green and followed by text that reads, “SMTP Server is enabled,” an SMTP configuration exists, and you do not need to proceed unless you need to edit the SMTP server settings.

  4. Click Configure SMTP server.
  5. The Add SMTP server modal opens.

  1. Enter the Server name. This is the fully qualified domain name of the SMTP service. This is a required field.
  2. In Server port, enter the SMTP service port number. This is usually 587. Port 25 or 465 can be used, but these are not recommended.
  3. The Socket options list allows you to specify the encryption to use. TLS encryption is used by default. Choose a different option from the list if preferred.

  4. The From field allows you to set an address to be used as the “from” information when the email message is generated. If you do not specify this information, the username will be used. This is a required field if a username is not provided.
  5. In Username, specify the SMTP username. This may be your email address, but it could vary depending on your service. This field is required if your SMTP server requires authentication.
  6. Use the Password field to specify the SMTP service password. In some instances, this will be the email password for the username specified, but this could vary based on the service you use. This is a required field if your SMTP server requires authentication.
  7. Click Test connection to test the connection to the server.
    If the test is successful, you will see a green message that reads, “SMTP server configuration test succeeded.”
    If the connection fails, you will see a red message that reads, “SMTP server configuration test failed.” Edit the information, and perform another test.

     
  8. Click Done to close the modal.
  9. You will now see a green circle followed by text that reads, “SMTP Server is enabled.”

SMTP Ports

For more information about SMTP ports, refer to information provided by SocketLabs.

 

Adding Email Recipients

Adding email recipients allows you to set notifications that trigger email messages when a subscribed event occurs. Because the notifications set here are global, they are not linked to a user, so notifications are not restricted to user-defined accounts, jobs, etc. This means you can send notifications to a user who does not have a DryvIQ account. For example, your Office Administrator or Billing Department may not have user accounts in DryvIQ, but you can add the corresponding email address to receive notifications regarding your DryvIQ license expiration so they can ensure proper renewal and payment as needed.

  1. Click Settings in the left menu.
  2. Click Notifications.
  3. Click Add email recipient. The Add email recipient modal opens.

  4. In Email address, enter the email address for the recipient you are creating. This is a required field.
  5. Use the Manage alert categories section to select the events that should trigger an email message to this recipient. Select the down arrow next to the category to view the notification options.
  6. Select the box for a notification event. A check mark indicates that it has been selected. The total number of selected notifications is displayed next to each category name.

  7. Select Save.
  8. The recipient will be added to a list on the right side of the screen.

Editing Notifications

You can select Configure for an email recipient in the list to edit the notification settings as needed.