SMTP Configuration

The software uses an SMTP configuration to send email notifications to its users. In the case when several SMTP configurations are enabled, the software tries to send email notifications using each of the configuration, sequentially following alphabetical order, until the email is successfully sent. Once one of the SMTP configuration successfully sends the email the software stops attempts to send the email using other configurations.

Some of the software components (for example, Email-based MFA) allows system owners to specify a specific SMTP configuration that can be used to send email notifications.

Creating a new SMTP Configuration

1. Log in to the 12Port Horizon tenant where you wish to support this SMTP configuration with an Administrator or Configuration Manager account.
2. Navigate to Configuration > SMTP and click the Add button.
3. Populate each of the parameters using the in-application help for details or use the following section as guidance.
   1. Name: Enter a unique, but recognizable name for this SMTP connection.
   2. Server: Enter the SMTP host server. If you are using Azure/Office365, enter smtp.office365.com.
   3. Port: Enter your SMTP port. If you are using Azure/Office365, enter 587.
   4. From Address: Enter the email address from which email will be sent.
   5. Start TLS: Enable TLS if your SMTP server supports this protocol. If you are using Azure/Office365, enable this TLS option.
   6. Timeout: Enter a timeout value defined in milliseconds. We recommend using the default value unless you encounter timeout issues, in which case you can increase as needed.
   7. Authentication: Select between Basic Authentication and Entra ID oAuth, the later is required for an Azure/Office365 SMTP connection.
      1. Basic Authentication:
         1. Account: Enter the username of the mailbox that will be used for sending emails.
         2. Password: Enter the password of the account used to send emails.
      2. Entra ID oAuth: Please see the next section Creating an Azure App Registration for SMTP for additional configuration steps.
         1. Account: Enter the username of the mailbox that will be used for sending emails.
         2. Password: Enter the password of the account used to send emails.
         3. Tenant ID: Enter the Azure Tenant ID from where your SMTP App Registration was created.
         4. Client ID: Enter the Azure Client ID of your SMTP App Registration.
         5. Client Secret: Enter the Value string from the Certificates & Secrets page that was created for this SMTP App Registration.
   8. Enabled: Enable this option to enable this SMTP connection.

Click the Save button to complete the SMTP configuration.

Creating an Azure App Registration for SMTP

If you are using Azure/Office365 for SMTP to send emails, then you must complete the steps in this section before creating your SMTP connection in Horizon.

Requirements

• The Account provided must have a valid Office 365 license for Exchange Online.
• The Account's mailbox settings must have SMTP AUTH enabled. For more information about SMTP AUTH: https://learn.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/authenticated-client-smtp-submission
• The Account provided must have Azure MFA disabled.

Azure App Registration

1. Log in to your Azure tenant, open the App Registration page and from here, click the New registration button.
2. On the Register an application form, enter a Name, selected the Support account types that you wish to support, and leave the Redirect URI parameter empty. Click the Register button to continue.

3. After the App Registration is created, from its Overview page, copy the Application (client) ID and Directory (tenant) ID.

   1. The Application (client) ID value will be used in the 12Port SMTP parameter named Client ID.
   2. The Directory (tenant) ID value will be used in the 12Port SMTP parameter named Tenant ID.

   

4. Next, we need to generate the secret Value for this App Registration.

   1. On the Overview page of this application, click on Add a certificate or secret for the Client credentials parameter then click the New client secret button. Enter a Description and select an Expires option. Click Add to continue.
   2. After the secret is created, copy the value of the secret by selecting and copying the full string from the Value column. Copy this Value string to the 12Port SMTP parameter named Client Secret. Please note that this value is only visible once from this screen. Once you close this page, the value cannot be viewed again.

   

5. Now we need to assign API Permission to this App Registration to permit the sending of emails from the supplied account.

   1. Navigate to Manage > API Permissions and click the Add a permission button.
   2. From the Request API permissions page, select Microsoft Graph and then Delegated permissions and include the following:
      1. SMTP.Send
   3. Click Add permission to complete your selection.
   4. Finally, click the Grant admin consent button to finalize the API Permissions for this App.

Test your SMTP Configuration

Once the SMTP configuration has been saved, use the Test Connection button to send a test email.

In the Destination Email field, enter an email address that will receive the test email notification using this SMTP configuration and click the Send button. If the configuration is successful, you will receive a Success message in the 12Port portal and a test email in the Inbox of the Destination Email mailbox.

Note

If you receive an error message, please review your SMTP configuration for any issues.