Skip to main content

 Configuration

Configuration manual for PageSeeder

Email configuration

How the email environment is configured can make a big difference to whether receiving email servers regard messages sent from PageSeeder as spam. Following are some guidelines for this task.

SMTP server

PageSeeder v6 and higher does not include an SMTP server for sending outgoing messages. To enable outgoing emails you must enter your own email server, or an email provider such as Gmail, Mailgun or SendGrid in the SMTP Server address on the Setup or System configuration > Email settings pages. This is the same as the smtpServerAddress in Global properties .

The SMTP connection security for production systems should be set to SSL/TLS (port 465) if available or otherwise STARTTLS (port 587).

The outgoing SMTP server usually needs to be configured to allow email relay from the PageSeeder server’s IP address or with a username and password for authentication.

The following instructions refer to the server PageSeeder is using for outgoing email as the SMTP server.

Reverse DNS entry

The SMTP server should have a reverse DNS entry. A normal DNS entry maps a domain name to an IP address (for example, when you type google.com, the DNS sends your browser to IP 74.125.227.128).

Reverse DNS means that a receiving email system can use an IP address to find the domain it is mapped to, and if it can’t or the domain is different from what it expects, might reject the email message.

Your ISP or network administrator can set up a reverse DNS entry for the SMTP server and there are many tools that can be used to check it has been set (such as the SMTP Test tool at http://mxtoolbox.com ).

Black lists

Email blacklists record the IP addresses of email servers they think are sending spam. If the SMTP server is on one of these lists, any messages PageSeeder sends are likely to be rejected.

Online tools can be used to find out if the SMTP server is on a black list (for example, the Blacklist Check tool at http://mxtoolbox.com ). To have the SMTP server IP address removed from a black list, the list maintainer might need to be contacted.

SPF

The Sender Policy Framework (SPF)  uses a special type of DNS entry which says that emails with a particular sender domain should be rejected unless the sending email server has one of the specified IP addresses.

Your network administrator should set up an SPF record for the IP address of the SMTP server for the email domain configured in PageSeeder. It is also recommended to have notifyFromAddress=noreply in PageSeeder so that all emails come from the same domain. For more information about email domain settings, see From address.

DKIM

DomainKeys Identified Mail (DKIM)  is a way of digitally signing emails which means that a particular domain is taking responsibility that the message is genuine.

All PageSeeder messages are automatically DKIM signed against the pageseeder.com domain, but this is only sufficient for testing (it can be disabled using the disableDefaultDKIM global property). Production server emails should have DKIM signed against their own domain either by their SMTP server or by setting up DKIM signing using the organization configuration.

Created on , last edited on