SMTP servers¶
The SMTP servers module declares the SMTP servers Bastion uses to send e-mail notifications. It is intended for an administrator who configures operational notifications: user logins, raised alerts, recording start, application events, and so on.
The components that consume those servers (notification profiles, users, authentication domains, sites, internal applications, alerts) must additionally be configured for a message to be actually sent.
List of SMTP servers¶
| Column | Description |
|---|---|
| Name | Label of the server in the console. |
| Server | DNS name or IP address of the SMTP server. |
| Port | TCP port used. |
| Connection type | TLS, STARTTLS or Insecure. |
| Username | Account used for SMTP authentication. |
A search field in the toolbar filters the list 700 ms after the last keystroke or immediately with Enter. Pagination at the bottom offers 15, 25 or 50 rows per page.
Add an SMTP server¶
Click +. The Add an SMTP server window opens.
Form fields¶
| Field | Description |
|---|---|
| Name | Identification label. A whitespace-only string is rejected. |
| Server | Mandatory. DNS name or IP address of the server. |
| Port: | Mandatory. Integer between 0 and 65536. Default value: 25. |
| Username: | Authentication account; leave empty when the server accepts anonymous sending. |
| Password | Matching password. When editing, the field shows a placeholder; only touch it to replace the password. |
| Connection type | TLS, STARTTLS or Insecure. |
| Use specific certificate authorities to validate the server certificate | Checkbox that enables the next field. |
| Certificate authorities to validate the server certificate (base64 encoding) | Certificate file in PEM format. A file that is not a valid base64 certificate is rejected with the message This file is not a valid base64-encoded certificate. |
Test the configuration¶
An SMTP configuration test block, collapsed by default, sends a test message without saving the server. An italic note recalls that The following data will not be saved.
| Field | Description |
|---|---|
| Destination email address | Address the test message is sent to. The e-mail format is checked. It is not stored with the server. |
| Configuration test | Sends a test e-mail using the current values of the form. |
Sender of the test message
The message is sent from the noreply@cleanroom.com address, set by the product: it cannot be configured anywhere and also serves as the reply-to address. The server under test must therefore accept that sender — a server restricting sending addresses will reject the test whatever configuration is entered. The message subject is SMTP configuration test and its body is empty.
Diagnosing test failures
The result appears below the button: Successful sending, or Failure. followed by a targeted message. Seven causes are recognised and named: DNS resolution, rejected credentials, unreachable network, address not compliant with RFC 5321, recipient outside an accepted domain, unsupported authentication method, certificate validation failure. Any other error is displayed exactly as the SMTP server returns it.
Click Validate to save the server.
Edit an SMTP server¶
Select a server then click the Properties icon (or double-click the row). The Edit an SMTP server window is identical to the add window, the password staying masked.
Delete an SMTP server¶
Select one or more servers then click ×. Deletion asks for confirmation. Multi-selection is supported.