Installation & Setup
Plug-Ins & Add-Ons
Sender Domain Management
The purpose of the “Sender Domain Management” feature is to provide a self-service sender domain setup for users. With this feature, a user account can register sender domains on the user area and make sure that they are 100% SPF/DKIM/DMARC compliant.
Before enabling this feature, you need to configure the DNS record schema for your users.
/opt/oempro/data/config.inc.php file and locate the
$EmailCampaignDNSTemplates code block. It should be around line #84. Here’s an example screenshot:
You can customize the DNS schema in any way you prefer but in order to make sure you comply with sender policies, you must make sure that your DNS schema supports SPF, DKIM, DMARC and other DNS records (ex: BIMI).
Our suggestion is to use setup a base DNS record domain and use it with CNAME approach. For example, if your base DNS record domain is
myesp.com, you can setup these DNS records on it:
# Inbound Bounce Handling # ----------------------- mx.myesp.com A <ip_address_of_your_inbound_bounce_addon> myesp.com MX 10 mx.myesp.com # SPF Policy Compliance # ----------------------- myesp.com TXT "v=spf1 ip4:<your_sender_ip_block> include:<any_third_party_service> -all" # Email Link Tracking and Redirection # ----------------------------------- myesp.com A <ip_address_of_your_link_proxy_addon>
Then you can just inherit it for your users’ sender domains:
$Subdomain.'._SenderDomain_' => ['CNAME', 'myesp.com'],
In addition to this, you may also consider adding DKIM and DMARC DNS records. You can see examples below:
'_dmarc.'.$Subdomain.'._SenderDomain_' => ['TXT', 'v=DMARC1; p=none; rua=mailto:email@example.com; ruf=mailto:firstname.lastname@example.org; sp=quarantine; fo=1; pct=100; ri=86400; adkim=s; aspf=s;'], 'key1._domainkey.'.$Subdomain.'._SenderDomain_' => ['TXT', 'k=rsa; p=<insert_your_dkim_public_key>'],
Then, you will need to set a DNS record for link tracking:
$TrackPrefix.'-'.$Subdomain.'._SenderDomain_' => ['CNAME', 'myesp.com'],
and finally, you will need to set a verification DNS record just to make sure the domain belongs to the user (to avoid phishing attacks from your server):
'_SenderDomainRandom_.'.$Subdomain.'._SenderDomain_' => ['TXT', '_SenderDomainHash_'],
Enabling Sender Domain Management
Once you are done with the configuration, the next is to enable the “Sender Domain Management” feature. This feature can be enabled for each user group separately. In this way, you can control which users can have access to this feature.
In the admin area, go to “Users” and click “User Groups” button:
Click on the user group you would like to activate this feature:
Save your user group settings. From now on, users of this group will need to setup their sender domains first in order to send an email campaign.
Setting Up a Sender Domain
Users can manage their sender domains inside the [User Area → Settings → Sender Domains] section:
Once DNS records for a sender domain are setup, that sender domain will have “ENABLED” label next to it as shown above.
When creating a new email campaign, you can choose one of those “enabled” sender domains from the list:
Additional Add-On Installations:
- Octeth Bounce MX Add-On: Install and use this add-on to capture incoming bounces and list-unsubscribe requests to an IMAP server for processing.
- Octeth Link Proxy Add-On: Install and use this add-on as a proxy for email link clicks and manage SSL certificates for tracking domains automatically.
Please do not hesitate to contact us for any questions you may have during the setup of the “Sender Domain Management” feature.