Sending Domains

Every email Full Fabric sends goes out through an email gateway: a sending route for a domain or an address. Gateways decide which addresses staff, campaigns and automations can send from, and make sure receiving mail servers trust those emails. They are managed in General settings › Infrastructure › Email gateways, with the feature core.institutions.settings_email_gateways_change.

Gateway Types

Type Shown as Description
System Managed by Full Fabric Present in every institution. Sends Full Fabric's own notification emails from its no-reply address. It cannot be edited or deleted.
Amazon SES Amazon SES, managed by Full Fabric Sends from the institution's own domain through Full Fabric's Amazon SES account, after the domain is verified.
Custom SMTP My own SMTP server Sends through the institution's own mail server, with its address, port and credentials.

The Gateways List

The Gateways tab lists Domain part, Address and port (or Managed by Full Fabric), Domain, Default sender and Default gateway. Row actions are Open gateway and Delete gateway.

Note: Domains with non-ASCII (UTF-8) characters are not supported.

Which Gateway Sends an Email

A gateway matches a sender in one of two ways, set by its Match type:

  • Domain: any address at the gateway's domain part, for example everyone @admissions.example.edu.
  • Address: only the addresses listed on the gateway.

A custom SMTP gateway with * as its domain part is a catch-all for senders no other gateway matches. Only enabled gateways are used.

The Default gateway supplies the institution's default sender name and email, used by campaigns sent with Default email and by some system emails. Only one gateway can be the default.

Adding an Amazon SES Gateway

Select Add a new gateway, choose Amazon SES, managed by Full Fabric and enter the Domain. The gateway page then walks through its steps, each marked Pending..., Completed or Failed... (with Retry).

Step What to do
Fill details Enter the Domain part, Default sender name and Default sender email, and choose whether to Set as default gateway.
Verify Domain Add the TXT record shown, at _amazonses.<domain>, to the domain's DNS.
Verify DomainKeys Identified Mail (DKIM) Add the CNAME records shown, of the form <token>._domainkey.<domain> pointing to <token>.dkim.amazonses.com. DNS changes can take up to 72 hours.
Verify Custom MAIL FROM domain (optional) Pick a Sub-domain and add its MX record (feedback-smtp.eu-west-1.amazonses.com, priority 10) and SPF TXT record (v=spf1 include:amazonses.com ~all).

Full Fabric checks the records every few minutes and moves the gateway forward on its own:

The gateway sends email only once it is enabled.

Adding a Custom SMTP Gateway

Choose My own SMTP server and fill in the Gateway details:

Field Description
Domain part The sender domain the gateway serves, or * for a catch-all
Server address, Server port, Domain The SMTP server's connection details
Authentication type PLAIN, LOGIN, CRAM_MD5 or NTLM
Username, Password The SMTP credentials
Default sender name, Default sender email Used when this gateway is the default
Match type / Addresses Match by Domain, or by the listed Addresses
Set as default gateway Make this gateway the institution's default sender

If the server rejects the credentials when sending, the person who last saved the gateway receives an email saying the gateway's authentication failed and its configuration needs review, at most once every 24 hours.

Marketing Gateway

The Marketing gateway tab sets a separate SMTP server (Server address, Port, Domain, User name, Password, Authentication type) for marketing emails. When it is set up, marketing emails, such as those of a marketing campaign, go through it instead of the matching gateway. Other emails are not affected. Disable the marketing gateway? turns it off again.

Personal SMTP

When the institution allows it, staff with the core.institutions.user_emails_smtp_settings feature can send their own emails through their own mail account. Under user settings › SMTP preferences, they enter SMTP server address, Port, Domain, Authentication type, User name and Password. The tab shows Current status: active. or inactive.

While active, a person's personal SMTP is used for every email sent from their address, ahead of the institution's gateways. If the server rejects the login, Full Fabric switches personal SMTP off and emails them that their personal email settings were deactivated and need review.