Configure SMTP Settings
This article provides a comprehensive introduction to SMTP and its components. It further describes how to configure SMTP to send email notifications and details the various parameters in the OvalEdge application that can be used for configuration.
Email has been around for decades and is still one of the most widely used communication methods worldwide. Whether for personal or business purposes, we rely on email to send and receive important information quickly and efficiently. The back-end process that occurs when the Send button is clicked during email transmission is SMTP.
SMTP (Simple Mail Transfer Protocol) is an application used by email clients (Yahoo, Gmail, Apple Mail, Outlook) to send and receive emails over the internet. It works with the mail transfer agent to route email across networks to the correct computer and inbox.
SMTP Server and SMTP Port
An SMTP Server, like any other server, is an application that provides a service to other applications within a network, allowing them to send, receive, and relay email messages. It is like a post office that processes and sends letters from City A to City B or their intended destination. Without a server, email communication between different domains, e.g., Gmail to Yahoo, would not be possible.
To route communications appropriately, any server requires two essential pieces of information:
First, a Domain Name or Internet address (IP) is used to identify the specific machine or server. It is similar to a street address, which identifies a physical location, but in this case, it is a unique identifier for a machine or server on the internet.
Second, a Port number is needed to identify a particular application or service running on the machine. It is similar to an extension number on a phone system, directing calls to a specific department or individual within the organization. SMTP uses ports 25 and 2525.
Setting up SMTP Parameters
Configuring the SMTP settings in the OvalEdge application is essential to ensure emails are delivered promptly to their intended recipients.
Users with Admin-level privileges can only configure the SMTP settings.
Valid email addresses must be provided during the user creation so that users can receive email notifications.
Users can set their email notification preferences from the list of options (Collaborations, System Alerts, Watchlist Alerts, etc.) by navigating to the ‘My Profile’ section.
To set up SMTP
Log in to the OvalEdge application
From the left menu, select Administration > System Settings.
Select the Notifications Tab from the top menu.
Enter the following parameters in the configurations.
ovaledge.smtp.server
Enter the SMTP server's IP address or hostname to send emails from OvalEdge to the recipient's email address.
Example: google.smtp2go.com
Parameters:
The default value is empty.
Enter the URL in the field provided.
ovaledge.smtp.port
Enter the SMTP Port number to connect to an SMTP server. Common values include 25, 2525.
Parameters:
The default value is empty.
Enter the port number in the field provided.
ovaledge.smtp.mode
SMTP operates in different modes: Unencrypted mode (without encryption) and Encrypted mode (with encryption).
SMTP can be used with encryption protocols such as SSL or TLS to secure email transmission from unauthorized access. It is an optional field.
Parameters:
The default value is empty.
Enter the value in the field provided.
ovaledge.email.username
Enter the username or account that is configured on the SMTP server.
Parameters:
The default value is empty.
Enter the username/account in the field provided.
ovaledge.email.password
Enter the password for the SMTP username/account configured on the SMTP server.
Parameters:
The default value is empty.
Enter the password in the field provided.
ovaledge.email.fromEmail
Enter the email address that should appear in the ‘From’ field of the email message when it is sent.
Example: [email protected]
Parameters:
The default value is empty.
Enter the ‘From email’ address in the field provided.
smtp.oauth2.tenantid
Enter Tenant ID for OAuth Token Validation and SMTP Server Authentication.
Parameters:
By default, this setting is Empty.
Enter a tenant ID in the field provided to validate an OAuth token and set up SMTP Server Authentication.
If set to False, virus scan on files is disabled.
smtp.oauth2.clientid
Enter Client ID for OAuth Token Validation and SMTP Server Authentication.
Parameters:
By default, this setting is Empty.
Enter a Client ID in the field provided to validate an OAuth token and set up SMTP Server Authentication.
smtp.oauth2.clientsecret
Enter Client Secret for OAuth Token Validation and SMTP Server Authentication.
Parameters:
By default, this setting is Empty.
Enter a Client Secret in the field provided to validate an OAuth token and set up SMTP Server Authentication.
smtp.oauth2.cloud.name
Enter Cloud Name for OAuth Token Validation and SMTP Server Authentication.
Parameters:
By default, this setting is Empty.
Enter a Cloud Name in the field provided to validate an OAuth token and set up SMTP Server Authentication.
Additional Information
To Configure OAuth for SMTP Authentication in Azure for OvalEdge
Create an App Registration in Azure
Navigate to the Azure Portal and access the "App Registration" page.
Click on "+ New Registration" to create a new app registration.
Provide a name for the app registration and complete the registration process.
Generate a Client Secret
After creating the app registration, access the "Certificates & Secrets" section.
Create a new secret and save its value for later use.
Retrieve Client-Id and Tenant-Id
Go to the "Overview" page of the app registration to find the Client ID and Tenant ID.
Configure API Permissions
In the "API Permission" blade, enable the necessary APIs and grant admin consent as required.
To enable the Office 365 Exchange Online APIs, please follow the steps below.
Under delegated permissions, add EWS.AccessAsUser.All as shown below.
Under Application Permissions, add SMTP.SendAsApp is shown below.
Adding Service Principal to OfficeExchange
Once the tenant admin has consented to the Azure AD application, register the AAD application's service principal in Exchange using Exchange Online PowerShell.
To do so, please run the following commands
Once login is successful, the following message will appear as below.
Once the Service principle is added, check the added service principles using the command below.
The OBJECT_ID is the Object ID from the Overview page of the Enterprise Application node (Azure Portal) for the application registration. It is not the Object ID from the Overview page of the App Registrations node. Using the incorrect Object ID will cause an authentication failure.
Give the application's service principal access to one mailbox shown below.
With the above, the entire configuration to use OAuth for SMTP is complete.
Enable SMTP Authentication in Office 365
Log in to the Office 365 Admin portal.
Enable SMTP Authentication for the service user created for OvalEdge's SMTP purposes.
Access "Manage email apps" and enable Authenticated SMTP as needed.
Upon completing the above steps, obtain the Client-Id, Client-Secret, Tenant-Id, and the email address of the service user for whom Authenticated SMTP is enabled.
Update OvalEdge SMTP Configuration
Log in to the OvalEdge application with admin credentials.
Navigate to the Administration > System Settings > Notifications tab.
Click the Settings tab to display the Notifications Settings page.
In the Settings page, edit the values for the following keys to update the SMTP configurations:
ovaledge.smtp.server: smtp.office365.com
ovaledge.smtp.port: 587 (adjust if necessary)
ovaledge.email.username: [email protected]
ovaledge.email.password: Leave it empty (update and save it with an empty value as it is not required for this SMTP configuration)
ovaledge.email.fromEmail: [email protected] (provide the service user's email address)
smtp.oauth2.tenantid: Your Tenant-Id
smtp.oauth2.clientid: Your Client-Id
smtp.oauth2.clientsecret: The secret value created in step 2
smtp.oauth2.cloud.name: Azure
Test SMTP Configuration
Testing the SMTP configuration is an important step to ensure the SMTP server is correctly configured and that email messages can be sent successfully. A 'Test' button is provided in the top-right corner.
In System Settings > Notifications, click the Test button in the top-right corner.
Click the Test SMTP option to open a confirmation pop-up window, then click the Confirm button. An email is sent to the admin user (who is configuring the settings).
If any required field is missing, a prompt will indicate which information is missing.
The admin user receives a test email from the service user in the format below.
Please ensure that the ovaledge.base.url of Administration > System Settings > System Path is updated with the OvalEdge instance URL.
Configuration History
A History icon is provided to view the list of changes made to the configuration. Click the History icon, and a pop-up window or dialog box will appear, displaying a list of changes made to the configuration. Each change ‘From’ and ‘To’ will be listed, showing the previous and current values of the configuration parameters, along with the date and time it was made and the user who made the change.
It allows users to easily track changes made to a configuration over time.
Important Note
Users must select the relevant checkboxes to receive Emails. To do so, click My Profile > Notifications Settings, then select the appropriate checkboxes, as shown in the image below.
The available alerts are related to the Data Catalog, Business Glossary, Projects, Service Desk, Governance Catalog, Data Quality, System Alert, Data Access Management, and Question Wall.
Copyright © 2026, OvalEdge LLC, Peachtree Corners, GA, USA.
Last updated
Was this helpful?