Email Settings
Overview
TLS Connect supports automated email notifications for common certificate lifecycle management and Automation Service actions via SMTP server set up. You can also specify recipient groups, email templates, and notification schedules.
To use this feature, you need a reachable SMTP server and its connection details: host, port, encryption and, if the server requires sign-in, a username and password.
Configure the SMTP Server
-
In Sender Configuration, enter the SMTP Host and Port.
-
Leave Enable SSL/TLS ticked unless the server does not use encryption.
-
Enter the Username and Password if the server requires sign-in.
-
Enter the Sender Name and Sender Email.
-
Click Test Connection. A test email goes to the sender and all group members.
-
When the status shows Connected Successfully, click Save Configuration.
Changes can be saved only after a successful test has been completed of the given values on the screen. A saved password is never shown; leave it blank to keep it.
Discard changes restores the saved values, and leaving the page with unsaved changes asks whether to save them.
The Enable SMTP activates notifications on or off. This toggle is available only after a successful test, and then sends a confirmation email to all recipients.
Troubleshooting
|
Common Messages |
What To Do |
|---|---|
|
Could not find the mail server |
Check SMTP Host |
|
Could not reach the mail server / timed out |
Check SMTP Host, Port and the firewall |
|
Server rejected or requires a secure connection |
Check Port together with Enable SSL/TLS |
|
Server rejected the connection or credentials |
Check Username and Password; some providers need an app password. |
|
Sender Email address not recognized |
Use a valid mailbox of the account |
|
An email address is not formatted correctly |
Check Sender Email and the group members |
SMTP Server Options
TLS Connect sends notifications through any SMTP server reachable from the TLS Connect server. The below table provides common setup configurations.
|
Option |
What To Prepare |
Settings in TLS Connect |
|---|---|---|
|
Internal mail relay |
An on-premises Exchange, Postfix or IIS SMTP relay that accepts mail from the TLS Connect server. |
Relay host and port; leave Username and Password empty. |
|
Microsoft 365 relay connector |
An inbound connector in Exchange Online that accepts mail from the TLS Connect server's public IP address (or a certificate). Outbound TCP 25 to the tenant MX host. |
Host: your tenant MX host, for example example-com.mail.protection.outlook.com; port 25; no sign-in. |
|
Microsoft 365 mailbox |
Authenticated SMTP (SMTP AUTH) enabled for the sending mailbox. |
smtp.office365.com, port 587, Enable SSL/TLS on, mailbox and password. |
|
Google Workspace / Gmail |
An app password for the sending account (2-step verification must be on). |
smtp.gmail.com, port 587, Enable SSL/TLS on, account and app password. |
|
Mail sending service |
An account at SendGrid, Mailgun, Amazon SES or similar. |
The service SMTP host and port; its user name, and its API key as the password. |
Recipient Groups
A group is a list of addresses plus the notification types its members receive. An address in several groups gets each email once.
To create a recipient group, follow the steps below:
- In Recipient Management, click + Create Group.
-
Enter a Group Name.
-
Enter an email address in Recipient Email and click Add Member. Repeat for each recipient.
-
Under Notification Event Type, tick the notifications that the group shall receive, or click Select All.
-
Click Save Group.
A group needs a unique name and at least one member. Group changes are saved immediately. Use the pencil icon to edit a group and the delete icon to remove it.
NOTE: After a software upgrade, new notification types are not subscribed to automatically. Edit each group to include them.
Email Notifications
|
Category |
Notification Type |
|---|---|
|
Certificates |
Certificate Expiring Soon, Certificate Expired, Certificate Issuance |
|
Automation |
Certificate Renewal Succeeded, Certificate Renewal Failed, Certificate Deployment Failed, Certificate Deployment Report, Automation Failed, Scheduled Job Failed, Integration Authentication Failed |
|
Agents and services |
Agent Offline, Service Status Changed, Agentless Certificate Downloaded |
|
Domains |
Domain Validation Expiring Soon, Domain Validation Expired |
|
License |
License Expiring Soon, License Expired |
The Certificate Deployment Report is sent once per automated renewal and lists the result for each target server. Agent Offline is sent when an approved agent stops contacting the Agent Hub.
All notifications except Certificate Issuance are sent by the Windows services so that notifications will be sent regardless of the TLS Connect application being open or closed.
Email Templates
Click Manage Templates to open the Template Editor. Each notification type can have several templates; the one in use is marked (Default).
Edit Email Templates
-
Select the Notification Type.
-
Click a template to load it, or click the Add Template icon to create one.
-
Enter a Subject and body in the provided fields.
-
To insert a variable, place the cursor in the body and click the + icon for it in the Available Variables section.
-
For email templates that have an “expiring soon” type, you can select how many reminders should be sent in Expiry Notification Settings.
-
Review your changes in the Preview section.
-
Click Save.
Save your changes before switching the notification type or template. Unsaved edits are discarded without a prompt.
Click the three-dots on a template and select Set as default to make that template the default of its type.
The Attach CSV File and Attach Certificate Zip variables add a CSV report or the certificate files as attachments to the email.
The default template and the last template of a type cannot be deleted.
Templates are edited and saved according to the language selector in TLS Connect. To edit templates in another language, change the TLS Connect language selector and then make your edits.
Notification Service
The TLS Connect Notifications Service checks certificates, domain validations and the license at the scheduled time. Without a saved schedule, it defaults to run daily at 09:00. The Notification Service card shows the service state, Last Run and Next Run. A check missed while the service was stopped runs when it starts again.
To set the notification schedule
-
In the Schedule section, choose the Start Date.
-
Enter the Time (24-hour, local time).
-
Select the frequency, either Daily, Weekly (choose the days) or Monthly (choose the day; short months use the last day).
-
Click Save Configuration. No new SMTP test is needed.
Service Actions install, start, stop, restart or uninstall the service. Stop, restart and uninstall act without confirmation, and no reminders are sent while the service is stopped.
Every email sent, failed or skipped is recorded in the email log in C:\TLSCONNECT (open it with Tools → Open Log Folder).