Notification servers
| Administration Page | Application/Contract | Syracuse/Collaboration | class | notificationServers | Representation | notificationServer |
|---|
This entity allows you to define mail servers able to push notifications to users.
It uses the nodemailer open source component.
In the notification event definition,
a dedicated mail server can be used. In the global setting
definition, a default mail server can also be defined.
The following information is associated with a mail server:
The name used to reference the mail server.
A user-friendly description. This information is entered by default in the current language.
Translation link:
You can enter descriptions in different languages using the corresponding widget.
This defines the type of mail server. Currently, only SMTP is available.
This is the path used to access to the mail server.
This is the port number associated with the mail server.
If this check box is selected, the connection is encrypted from the very beginning (like a “https” request). If the check box is not selected, there may be encryption when client and server agree on it (startTLS).
Defines the server on which the mail client runs.
This field has two choices:
This defines the email address of the notification sender.
Opening a client session to send emails to the server is transparent when sending a notification, but it can be costly. This is why this parameter defines a time value (in milliseconds). When several notifications are sent during the time interval fixed by this parameter, the mail connection will remain open. It is only closed if the idle time is reached since the last notification.
For TLS (transport layer security), the mail server authenticates with a server certificate and so can enable encrypted secure connections (as with HTTPS). When you use self-signed certificates for the mail server or certificates which are not issued by known certificate authorities, you may add the corresponding certificates of the certificate authorities here.
When you do not check this checkbox, the usual checks for TLS server integrity are not performed. This only makes sense for internal test environments which can use self-signed certificates, because it opens a big security hole: it enables man-in-the-middle attacks and removes most of the security of TLS connections.
Defines an optional list of option codes for the SMTP transport and their values. The option codes are those allowed by the nodemailer component. The option code that is given must not include option., but only the last element of the option.
Note: port, host, secure, auth and name are already contain values defined by the other parameters. It is therefore not necessary to define them, but if you do so, the values found in the grid will replace the defaults.
Indicates an optional theme that is used to format the email sent by the server.
The only operation available here is Test configuration. When this operation is triggered, a pop-up window opens where you can enter an email address, and a test email is sent to this address. If the email sending succeeds, a success message displays on the header line of the page.