Configure SMTP Mail Server
- Last UpdatedJun 05, 2025
- 3 minute read
You can configure an SMTP mail server in Central Configuration to enable email functionality in AVEVA Work Tasks. These default settings are used to send email notifications.
Two types of authentication are supported for SMTP:
-
OAuth2 (Recommended)
-
Basic
Important: Ensure that the user account is an Office 365 account with the required SMTP permissions to send emails.
Configure SMTP Using OAuth2 Authentication
OAuth2 provides secure token-based authentication. Use the following fields to configure the SMTP mail server for sending emails:
Configuration fields - OAuth2
|
Parameter |
Description |
Example Value |
|---|---|---|
|
Host |
SMTP server address |
smtp.office365.com |
|
Port |
SMTP port number. The default port is 25. |
587 |
|
Email Timeout |
Wait time before timeout (in seconds). The default timeout is 10000. |
100000 |
|
Is SSL Enabled? |
This field is used to define if the email has to be secured by SSL before it is sent. The default value is False. |
True |
|
Authentication |
Login method |
OAuth2 |
|
Exception From Email |
Sender email from which alert messages are sent |
user@domain.onmicrosoft.com |
|
Exception To Email |
Recipient email that receives alert messages |
sampleuser@domain.onmicrosoft.com |
|
User Account |
Email address used for sending emails |
user@domain.onmicrosoft.com |
|
OAuth2 Token URI |
URI to obtain the access token |
https://login.microsoftonline.com/<<TenantID>>/oauth2/v2.0/token |
|
Authorization Code URI |
URI to obtain authorization code |
https://login.microsoftonline.com/<<TenantID>>/oauth2/v2.0/authorize |
|
Client ID |
OAuth2 application client ID |
Copy from SMTP App registrations |
|
Client secret |
OAuth2 application client secret |
Copy from SMTP App registrations |
|
Redirection URI |
URI where the user is redirected after login/authorization |
https://<MachineName>:8001/CentralConfig/SMTPConfig.aspx Note: You must register this Central Configuration URL in Azure App Registration. |
|
OAuth2 Scope |
Permissions requested |
https://outlook.office.com/SMTP.Send offline_access |
|
Parameters |
Additional parameters required for OAuth2 authentication |
&prompt=consent&access_type=offline |
|
Token Refresh |
How long the access token is valid before it needs refreshing (must be < 1 hour) |
0.00:50:00 |
Steps to Configure
-
Open the Central Configuration page.
-
Navigate to Mail Server Settings > Manage SMTP Settings page.
-
Enter the OAuth2 configuration details as shown in the table above.
-
Click Save to store the settings.
-
Click Get Access Token.
-
You will be redirected to log in to your O365 account.
-
Click Continue to verify and grant access.
Configure SMTP Using Basic Authentication
This method uses a username and an app-specific password to connect to the mail server.
Notes: Anonymous email sending is not supported. You must provide a valid username (email address) and password for Basic authentication.
Configuration fields - Basic authentication
|
Parameter |
Description |
Example Value |
|---|---|---|
|
Host |
SMTP server address |
smtp.gmail.com |
|
Port |
SMTP port number. The default port is 25. |
587 |
|
Email Timeout |
Wait time before timeout (in seconds). The default timeout is 10000. |
100000 |
|
Is SSL Enabled? |
This field is used to define if the email has to be secured by SSL before it is sent. The default value is False. |
True |
|
Authentication |
Login method |
Basic |
|
User Name |
Email ID used for SMTP login |
user@gmail.com |
|
Password |
App password for the email (generated through two-step verification) |
Gmail App Password |
|
Exception From Email |
Sender email from which alert messages are sent |
user@gmail.com |
|
Exception To Email |
Recipient email that receives alert messages |
sampleuser@gmail.com |
Steps to Configure
-
Open the Central Configuration page.
-
Navigate to Mail Server Settings > Manage SMTP Server Settings page.
-
Fill in the fields as shown in the table above.
-
Click Add Users, and then provide the Username and Password.
-
Click Save.
-
Go to Manage Repository > Mail Settings.
-
Update the From Mail and Exception To Email fields.
Notes:
- Use the same email address for both the From Mail field (under Manage Repository) and the SMTP Username.
- The mail host must be configured with a valid username and password.
- To enable email-based interaction for any Human Activity (such as Task, Approval,
Choice, or Checklist), ensure that the Mail delivery channel is enabled for that activity.
Refer to Delivery Channels - MailWorkList for instructions.