Configuring Email Settings

To configure Email settings:

1. From the top right corner of any page, click . The System Settings page opens.
2. In the Categories/Subcategories pane of the System Settings page, expand External Integrations, and select Email.
   

• Send emails (required, default: switched off) - Toggle on to use an Email server. A configured Email server is a prerequisite before you can configure an email notification as part of a configured Enforcement Set or configuring a report to be sent via mail.

  • Define the Email host name and Port.
  • SMTP Authentication Type - Select the SMTP Authentication type, either Password Authentication, or OAuth2 Authentication.

Password Authentication

When you choose Password Authentication, you can configure a User name and Password (optional).

OAuth2 Authentication

When you choose OAuth2 Authentication, set the following:

• OAuth authentication email - The email for which the OAuth token was created.
• OAuth client ID - Standard OAuth parameter
• OAuth client secret - Standard OAuth parameter
• OAuth refresh token - The derived value of creating active tokens from Client ID and Secret ID (procedure is standard)
• OAuth URL - The URL to authenticate with and which generates the Access tokens, for example:
  • Microsoft AD:

            https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token

• Google:

             https://accounts.google.com/o/oauth2/token

Microsoft Azure AD Permissions
You need to grant the following permissions

General Email Configuration

• Use SSL for connection - Configure the connection to be Unencrypted, Verified, or Unverified.
  • When you select the Verified or Unverified options, you need to provide the SSL CA file, Certificate file, and Private key file.
  • When you select the Unencrypted option, the system attempts using TLS when sending emails (the default; no TLS configuration required). If TLS fails and the connection is active (if lost, the system first reestablishes the connection), the system proceeds to send emails without TLS.
• Define the Sender address for all emails sent by Axonius. If empty, the sender address is 'system@axonius.com'.
• Compress email attachments (default, false) - Select this option to compress email attachments. This affects email attachments sent from reports and those sent as part of the Send email Enforcement Set action.
  • When this feature is activated, email attachments are sent as one compressed attachment in zip format.
  • When this feature is not activated, all email attachments are not compressed, and are sent as separate files.