Getting started

Roadmap

Octeth Training Program

Installation & Setup

Community Edition Install

SSL Certificates

Version Upgrade

Troubleshooting

Video Tutorials

Administration

Audience Management

Website Event Tracking

Email Marketing

Journeys (Automation)

Bounce Processing

Email Personalization

FBL Processing

Email Builder Integrations

Email Deliverability

Sender Domain Management

Plug-Ins & Add-Ons

AI Plug-In

RSS Plug-In

Bounce Catcher Add-On

Developers

API

Advanced

Help

Sender Domain Management

⚠️

This feature is available on Octeth v5.1.1 and newer versions.

Getting Started

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.

Configuration

Before enabling this feature, you need to configure the DNS record schema for your users.

Edit /opt/oempro/data/config.inc.php file and locate the $EmailCampaignDNSTemplates code block. It should be around line #84. Here’s an example screenshot:

An exampe DNS schema configuration

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:dmarc@yourdomain.com; ruf=mailto:dmarc@yourdomain.com; 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_'],

ℹ️

The DNS structure decision process can be confusing. Please do not hesitate to contact us. We will be happy to help and share some examples.

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:

Choosing the sender domain when creating an email campaign

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.