Mail Notification

The Create Agent wizard prompts for the basic properties needed to send email notifications when using an unauthenticated SMTP server listening on the default port of 25. These values can be changed later using the Configuration panel of SQDR Control Center.

SmtpServer
from
to
notificationLevel

In addition, the following properties can be added to the configuration of each agent if needed:

mailUser
mailPassword
mailOptions

See Configuration for information on how to edit, add, or delete properties, and the Configuration Reference for details about the properties.

Troubleshooting

Errors related to mail notification appear in the wrapper.log of the Launch Agent; this file is located in C:\ProgramData\StarQuest\sqdrplus\conf (Windows) or /var/sqdrplus/conf (Linux).

If your system is blocked from accessing outside mail servers, you may see errors related to the StarQuest mail server mail.sqven.com.  To disable StarQuest Notifications, set starquestNotification=OFF in the Agent configuration or uncheck the checkbox when adding a new Agent.

Office365 Hints

To send email using Office365, use one of the following configurations:

Direct Send

To use Direct Send (typically used for printers, scanners, other devices, and applications):

SmtpServer=your-domain.mail.protection.outlook.com (the MX endpoint for your Office 365 tenant)
mailOptions=mail.smtp.starttls.enable=true;mail.smtp.ssl.trust=your-domain.mail.protection.outlook.com

Advantages:

• This method does not require authentication.

• The from address can be any meaningful name as long as it is properly formatted e.g. sqdr@mydomain.com. It does not have to be a registered/licensed Office365 user.

Disadvantages:

• You can't relay to an email address outside your domain.

• Your IP address has to be white-listed, which adds complications when SQDR is running in the cloud (e.g. AWS or Azure).

SMTP client submission endpoint

Use SMTP client submission endpoint (typically used by email client applications like Outlook) to send email to an address outside your domain:

SmtpServer=smtp.office365.com
mailOptions=mail.smtp.starttls.enable=true;mail.smtp.port=587;mail.smtp.ssl.trust=smtp.office365.com

You must configure authentication (mailUser and mailPassword).

The value specified for mailUser must match from.  This means using a registered/licensed Office365 user, and the From address may not be as descriptive as it could be otherwise, especially if you are using multiple SQDR servers.

Office 365 SMTP relay connector

Configure a Office 365 SMTP relay connector to authenticates your device or application with Office 365 using an IP address or a certificate.

The Office 365 administrator creates an SMTP relay connector in the Exchange admin center, specifying Your organization's email server in the From dropdown, and supplying your static IP address.

Configure the SQDR Plus agent as above for Direct Send:

SmtpServer=your-domain.mail.protection.outlook.com (the MX endpoint for your Office 365 tenant)
mailOptions=mail.smtp.starttls.enable=true;mail.smtp.ssl.trust=your-domain.mail.protection.outlook.com

Advantages:

• This method does not require authentication.

• The From address can be any meaningful name as long as it is properly formatted e.g. sqdr@mydomain.com. It does not have to be a registered/licensed Office365 user.

• You can relay to an email address outside your domain.

Disadvantages:

• Your Office365 administrator must create the connector.

• You must use a static IP address that belongs to your organization exclusively.

• The connector could potentially be abused by other devices and computers within your network. For example, a compromised desktop computer within your network could use the connector to send spam to external addresses.

For detail, see the Microsoft documentation.