Administration

SMTP and e-mail delivery

Store the mail server through which EasyUC sends notifications and sign-in codes.

EasyUC · Version 4.8.7

In EasyUC: EasyUC Cisco → Administration → System & Operations → System Configuration → SMTP Configuration

What it is for

EasyUC sends e-mails through an SMTP server that you enter here. It is used for the event mails to users (for example after a phone has been created), the codes for two-factor sign-in, error messages from webhooks and scheduled reports.

There is exactly one SMTP configuration for the entire installation. When you save, EasyUC opens a test connection to the mail server. If it fails, nothing is saved.

Prerequisites

An account with the access type Administrator (full access) (ROLE_APP_ADMIN) or the owner account (ROLE_OWNER). Only these accounts see the Administration menu.
Host name or address of the mail server, port and the permitted connection security.
A sender address that the mail server accepts for this system.
If the mail server requires authentication: user name and password of a sending account.
The mail server can be reached from the EasyUC server.

Step by step: entering the mail server

Open the EasyUC Cisco workspace.
Select Administration → System & Operations → System Configuration → SMTP Configuration.
Switch on Enable. The remaining fields appear only then.
Under Host, enter the mail server, for example mail.intern.
If the server requires authentication, switch on Credentials and fill in Username, Password and Retype Password.
Under Connection Security, select the entry Secure or Not Secure.
Enter the Port and, under From, the sender address.
Click Save. On success the message Success appears.

Step by step: testing delivery

After saving, click Send Test E-Mail. The button appears only when the configuration is enabled and saved.
In the window Send Test Email, enter the recipient address. The field is labelled To.
Click Send.
Check that the message arrives in the mailbox, including the spam folder.

Fields and options

Fields and options
Field / action	Meaning and use
Enable	Switches e-mail delivery on. Default: off. Without active delivery, neither notifications nor sign-in codes are sent.
Host	Host name or address of the mail server.
Credentials	Switches SMTP authentication on. Off: the user name and password fields are locked.
Username	Sign-in name on the mail server.
Password / Retype Password	Password of the sending account. A stored password is no longer displayed. Below the fields the following note then appears: A password is stored. Leave empty to keep it (only for the same host and port and without switching to "Not Secure").
Connection Security	Secure (encrypted, default) or Not Secure (unencrypted).
Port	Port of the mail server, matching the connection security.
From	Sender address of all EasyUC mails.

Checking the result and narrowing down errors

Success: message Success after saving and a test e-mail in the mailbox.
Saving fails and shows an error message from the mail server: EasyUC cannot reach the server or the authentication is rejected. Check the host, port, connection security and credentials as well as firewall rules between EasyUC and the mail server.
If you changed the host or port or switched to Not Secure, you have to enter the password again. EasyUC does not send a stored password to a different server.
The connection is established but mails do not arrive: the mail server rejects the sender or the recipient. Check the log of the mail server and the address under From.
Which events trigger a mail and what it contains is defined under E-mail Notification.