On this page

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 

atlas-tlsc-emails14.png

  1. In Sender Configuration, enter the SMTP Host and Port. 

  2. Leave Enable SSL/TLS ticked unless the server does not use encryption. 

  3. Enter the Username and Password if the server requires sign-in. 

  4. Enter the Sender Name and Sender Email. 

  5. Click Test Connection. A test email goes to the sender and all group members. 

  6. 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:

  1. In Recipient Management, click + Create Group.

    atlas-tlsc-emails15.png
  2. Enter a Group Name. 

  3. Enter an email address in Recipient Email and click Add Member. Repeat for each recipient. 

  4. Under Notification Event Type, tick the notifications that the group shall receive, or click Select All. 

    atlas-tlsc-emails16.png

  5. 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). 

atlas-tlsc-emails7.png

Edit Email Templates 

  1. Select the Notification Type. 

  2. Click a template to load it, or click the Add Template icon to create one. 

  3. Enter a Subject and body in the provided fields.  

  4. To insert a variable, place the cursor in the body and click the + icon for it in the Available Variables section. 

  5. For email templates that have an “expiring soon” type, you can select how many reminders should be sent in Expiry Notification Settings. 

  6. Review your changes in the Preview section.

  7. 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. 

atlas-tlsc-emails12.png

To set the notification schedule 

  1. In the Schedule section, choose the Start Date. 

  2. Enter the Time (24-hour, local time). 

  3. Select the frequency, either Daily, Weekly (choose the days) or Monthly (choose the day; short months use the last day). 

  4. 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).