Introduction

This article describes how to configure SES to use external SMTP server for reset password mail notifications.

Note: This procedure is different than the one to configure SMTP Translator addon.

Procedure

Pre-Installation Configuration

If you are configuring this part before launched the node ses-installer script, please follow this section (as these data will be stored then into MongoDB during the ses-installer deployment)

The configuration must be done in /opt/systran/apps-node/enterprise-server/config/default.yaml by filling the following section:

Email:
 smtp: external
 options:
 service: smtp
 port: 25
 host: <hostname or ip address of the smtp server>
 secure: false/true
 auth:
 ignoreTLS: false/true
 name: <optional>
 localAddress: <optional>
 connectionTimeout: <optional>
 greetingTimeout: <optional>
 socketTimeout: <optional>
 authMethod:
 tls: false/true

Settings are:

- port - is the port to connect to (defaults to 25 or 465)
- host - is the hostname or IP address to connect to (defaults to 'localhost')
- secure - use SSL
- ignoreTLS - ignore server support for STARTTLS
- requireTLS - forces the client to use STARTTLS
- name - the name of the client server
- localAddress - outbound address to bind to (see: http://nodejs.org/api/net.html#net_net_connect_options_connectionlistener)
- greetingTimeout - Time to wait in ms until greeting message is received from the server (defaults to 10000)
- connectionTimeout - how many milliseconds to wait for the connection to establish
- socketTimeout - Time of inactivity until the connection is closed (defaults to 1 hour)
- lmtp - if true, uses LMTP instead of SMTP protocol
- logger - bunyan compatible logger interface
- debug - if true pass SMTP traffic to the logger
- tls - options for createCredentials
- socket - existing socket to use instead of creating a new one (see: http://nodejs.org/api/net.html#net_class_net_socket)
- secured - boolean indicates that the provided socket has already been upgraded to tls

You can find more information about these option here.

Post-Installation Configuration

If you are configuring this part in post installation (after launching the node ses-installer), the default values had been stored into MongoDB and you have to change them directly into the database.

You can edit the content of settings database through MongoDB shell or MongoDB GUI tool (like Robomongo).

Below, a configuration example for a basic smtp with no certificate, no authentication and no TLS:

"Email" : {
"smtp" : "external",
"options" : {
"service" : "smtp",
"port" : "25",
"host" : "hostname or ip address of the smtp server",
"secure" : false,
"auth" : null,
"ignoreTLS" : true,
"name" : null,
"localAddress" : null,
"connectionTimeout" : null,
"greetingTimeout" : null,
"socketTimeout" : null,
"authMethod" : null,
"tls" : false }
},

Other setting

You can also change the address in the "from" field in the email sent to reset a password in "Administration > Settings > Security settings > Reset password settings". By default the value is no-reply@systran.fr