SMTP
Send Aegis email through your own mail server.
Aegis sends email for notifications, invitations and reminders. The SMTP connector tells it which mail server to use, which account to log in with and which sender address to show. SMTP (Simple Mail Transfer Protocol) is the standard way programs hand email to a mail server.
At a glance
| Direction | Out of Aegis. |
|---|---|
| What it sends | The email Aegis sends — notifications, invitations, reminders — when your instance has no system mail server. |
| Where it lands | The recipients' mailboxes, from the sender address and name you set. |
| Credentials and permissions |
The server, port, username, password and encryption
(none,
tls or ssl) of an account allowed to send
as the sender address.
|
| Owner of imported records | Not applicable: nothing is imported. |
| When it runs | At the moment an email is sent. |
| Set it up |
/connectors/smtp, by a Manager or Admin, when the SMTP
connector module is enabled for your organisation. The status stays
Disconnected until a connection test succeeds.
|
Who uses it
The connector page is for
Manager and
Admin. A
Contributor or
Viewer who opens
/connectors/smtp gets a 403
Access denied page with a Go to Dashboard button;
there is no read-only view. Reading, saving, testing and deleting the
configuration are each checked separately on the server, and all of them also
need the SMTP connector module to be enabled for your organisation.
What's on this screen
The page opens from the SMTP tile in the
Connectors
catalogue. This guide has no screenshot of the configuration form; the
Connectors chapter shows the access-denied page a Contributor gets here. From
top to bottom, the page shows:
-
Breadcrumb and header.
Connectors / SMTP(the first part links back to the catalogue), the titleSMTP Configurationand the line “Configure email delivery for notifications and alerts.” -
Status banner. It appears only once a configuration has been saved, and
reads
Status: Disconnected,Status: ConnectedorStatus: Error. When the last test failed, aLast recorded errorpanel shows the reason and when it was recorded. -
Server Settings. The requiredSMTP Host(placeholdersmtp.example.com) andPort(pre-filled with587) side by side, thenEncryptionwith three choices:None,STARTTLS(the default) andSSL/TLS. -
Authentication.UsernameandPassword. Under the password is the hint “Leave blank to keep existing password”. -
Sender Settings. The requiredFrom Address(placeholdernoreply@example.com) and the optionalFrom Name(placeholderAegis GRC). -
Actions.
Cancel(back to the catalogue) andSave Configurationat the foot of the form. After the first save,Test Connectionjoins them andDelete Configurationappears on the left. -
Configuration Notes. A help card below the form: common ports (25 for SMTP, 465 for SSL, 587 for TLS/STARTTLS), a reminder that STARTTLS on port 587 suits most modern providers, that passwords are encrypted at rest and never shown after saving, and that you should test after saving.
Setting up the connector
-
Enter your mail server in
SMTP Hostand itsPort. Both are required; an empty one stops the save withSMTP host is requiredorSMTP port is required. The host must be a host name or an IP address, and the port a number from 1 to 65535. -
Choose the
Encryption.STARTTLSstarts plain and then switches to an encrypted connection, usually on port 587.SSL/TLSis encrypted from the first byte, usually on port 465.Nonesends everything, password included, unencrypted; use it only on a network you trust. -
Fill in
UsernameandPasswordif your server needs a login. Leave both empty for a server that accepts mail without one. On a later visit, leave the password as it is to keep the saved one. -
Enter the
From Addressrecipients will see, and optionally aFrom Name. An empty address stops the save withFrom address is required. The account above must be allowed to send as that address, or your server may refuse the mail. -
Select
Save Configuration. The button readsSaving..., then a green “Configuration saved successfully.” message appears above the form and the status banner readsStatus: Disconnected. Every save sets the status back toDisconnected, so test again after any change.
If the server refuses the settings, the page shows only
Failed to save configuration. That happens, for example, with a
host such as localhost, a port above 65535, a
From Address that is not a valid email address, or a
Username or From Name longer than 255 characters.
Check each field against the rules above and save again.
Changing the server or port asks you to enter the password again: a stored
password is only sent to the server it was entered for. The same applies
when you switch
Encryption to None: the stored password is only
sent over the protection it was entered with. Until you type the password,
the save is refused with a message saying so.
Testing the connection
Test Connection appears only after a configuration is saved, and it
tests the saved settings, not unsaved edits in the form.
-
Select
Test Connection. The button readsTesting...while Aegis connects to your server and waits up to ten seconds for it to answer as a mail server. Save and test are both locked until it finishes. -
Read the result above the form. A green “SMTP connection successful” sets
the status to
Connected. A red message sets it toError, and the reason is recorded under the status banner.
Failure messages are deliberately short: SMTP host blocked when the
server resolves to a network Aegis will not connect to, and
Connection failed for anything else, such as a wrong port, a
timeout or something other than a mail server answering. Every test, whatever
its outcome, is written to the audit log.
The test confirms that a mail server answers at the host and port. It does not log in, check the server's certificate or send an email. A wrong password or a sender address the account may not use only shows when Aegis sends real mail, so send yourself a notification after setting up.
Deleting the configuration
-
Select
Delete Configuration, bottom left. A dialog asks “Are you sure you want to delete this connector configuration?” - Confirm. The server, login and sender settings are removed, the deletion is recorded in the audit log, and you return to the connectors catalogue.
Tips and limits
-
A mail server configured for your instance by Euraika takes precedence over
this connector; ask Euraika which one your instance uses. In some set-ups
that server has no sender address of its own, and the
From AddressandFrom Namesaved here are used instead. -
Port 465 is always treated as
SSL/TLS, whateverEncryptionsays, both when testing and when sending. -
The status records the outcome of the last test. It does not switch sending
on or off: when no system mail server is configured, Aegis uses the saved
settings even while the status reads
Disconnected. -
Loopback, unspecified and link-local addresses (such as
localhostor127.0.0.1) are refused as the host, both when saving and when sending. - Each organisation has one SMTP configuration. Saving again replaces it.
Where this connects
All connectors are listed in Connectors. What triggers an email is described in Notifications; notification preferences are in Settings. To send events to another system over HTTP instead, see Webhook. Saves, tests and deletions appear in the audit log.