As an application from outside your organisation, in order to send emails to your customers on your behalf, Arlo requires some set up to be completed.
This article explains the benefits of each of the available options and covers the process of checking if your domain uses SPF (Sender Policy Framework) records (and how to update those records to work with your Arlo platform), what is DKIM and why you should set this up, and how to send emails if you do not wish to use your own organisation's domain.
As many of the steps involved are completed outside of Arlo, and require access to edit your domain settings, your domain administrator/provider may need to assist with these processes.
On 1 February 2024, Google released a very strict email policy requiring that you set up SPF and/or DKIM email authentication for your domain. This will affect the delivery of emails to registrants who sign up to your courses with a Gmail address or any businesses that use a Google Workspace email. Please read How to check and update an SPF record and How to set up DKIM below and action, if required. Please email support@arlo.co if you have any questions.
What is SPF?
SPF is an extension to internet e-mail. It prevents unauthorized people from forging your e-mail address.
What if my domain doesn't use SPF Records?
Not all domain administrators choose to configure SPF records. If your domain doesn't use SPF records, there's nothing more that needs to be configured. As a best practice, Arlo does recommend that domain admins consider creating an SPF record. This decision and configuration change should be planned though, as creating a record without proper testing might disrupt mail delivery for other email systems in your organisation.
Why do we need to change anything?
On 1 February 2024, Google released a very strict email policy requiring that you set up SPF and/or DKIM email authentication for your domain. This will affect the delivery of emails to registrants who sign up to your courses with a Gmail address or any businesses that use a Google Workspace email. Please read How to check and update an SPF record and How to set up DKIM below and action, if required. Please email support@arlo.co if you have any questions.
Arlo sends out emails when individuals place orders, register for courses, etc. The emails that Arlo sends out will often have a From address of something like training@mycompany.co.nz
where mycompany.co.nz is your domain, and our systems need to be authorised to send messages on your behalf.
When processing mail and looking for spam, servers will look for SPF records on mycompany.co.nz when trying to determine whether incoming mail is being sent by an authorised server. SPF records represent a list of authorized systems that your domain administrator has configured.
If the server receiving the mail cannot find an SPF record that authorizes Arlo's servers to send mail, the messages that we send may be marked as spam. The specific action taken when a message fails an SPF check depends on how the mail administrator has configured their server. Some may drop the message, some may record the SPF check fail, but still allow it to be delivered.
So that your registrants/customers receive all course communications, it is important any existing SPF record on your domain is changed to specifically include the Arlo mail system references.
Look up an SPF Record
- Confirm your company email address domain e.g. michael@mycompany.co.nz. In this case
mycompany.co.nz
is the domain name to check in the SPF tool.
- Navigate to https://mxtoolbox.com/spf.aspx. On this page, enter the domain name to be checked in the Domain name field and click SPF Record Lookup.
- On the results screen, check to see if your domain has an existing record.
Example: Output if you have no records.
Example: Output if you have existing records (will look something like the text below).
- If you have an existing record, you need to update it by following the rest of this process. If you do not have any existing SPF record, you don't need to do anything further.
Updating an existing record
The existing record needs to be changed to include the clause:
include:_spf.arlo.co
(underscore inclusive)
A full SPF Record with this addition might look like this:
v=spf1 mx include:cmail.com ip4:202.49.115.198 include:_spf.arlo.co -all
The include clause must be added before the "all" clause at the end. Note: it doesn't matter where in the record it is added, as long as it isn't after the "all".
Testing the updated SPF record
- Navigate to https://mxtoolbox.com/spf.aspx and check your domain again.
Any change you made may take several minutes to appear, so don't worry if your changes don't immediately appear at this point.
- Check there are no warnings given for your record. The test results should have green ticks as illustrated below.
- DNS changes take time to propagate. Once the record is updated on a live DNS server, it may take 1-24 hours for the change to affect your email delivery. The exact time depends on the TTL setting for your SPF DNS record. If you are updating your SPF records because you are having problems with email delivery, please give the records time to take effect.
If you have an existing SPF record, you need to find your existing domain SPF record, and update it to include the Arlo SPF reference (underscore inclusive):
include:_spf.arlo.co
(underscore inclusive)
For example, a full SPF record after this addition might look like:
v=spf1 mx include:cmail.com ip4:202.49.115.198 include:_spf.arlo.co -all
Once this updated DNS record has propagated, Arlo will be authorised to send email using your own domain.
What is DKIM?
DKIM helps protect email senders and recipients from spam, spoofing, and phishing by providing an encryption key and digital signature that verifies that an email message was not faked or altered.
How does DKIM work?
DKIM uses a pair of keys, one private and one public, to verify messages.
A private domain key adds a digital signature to the header to all outgoing email messages.
A matching public key is added to your Domain Name System (DNS) record. Recipient's email servers look up the public key and use it to decrypt the signature in the header of the email and verify that the email is authentic and unaltered.
Why should I set up DKIM?
Many public email providers, such as Gmail, are increasingly filtering emails which do not have verifiable DKIM signatures to spam, in order to protect their users from the ever increasing amount of email scams and phishing attempts.
DKIM helps to ensure emails sent from your domain are recognised by incoming mail servers as authentic and unaltered.
On 1 February 2024, Google released a very strict email policy requiring that you set up SPF and/or DKIM email authentication for your domain. This will affect the delivery of emails to registrants who sign up to your courses with a Gmail address or any businesses that use a Google Workspace email. Please read and How to check and update an SPF record above and How to set up DKIM below and action, if required. Please email support@arlo.co if you have any questions.
Setting up DKIM for your platform is a three step process that requires steps by both the Arlo Support team and your technical staff (as it requires the addition of some CNAME records to your DNS).
Step 1: Arlo generates the CNAME records
If you would like to set up DKIM for your emails, the first step is to contact Arlo Support or your Customer Success Manager. You should provide the email address your emails are sent from, the name and email address of the technical staff member who will be adding the records to your DNS and, if known, your DNS host.
The Arlo platforms send emails using SendGrid. If you already have CNAME records for SendGrid for another application, please let us know. We are able to add custom identifiers to the records to differentiate them in your DNS.
The Arlo Support agent will generate the CNAME records for your platform and send the details through to your technical staff member for addition to your DNS.
Step 2: Add the CNAME records to your DNS
Once received, your technical staff member will need to add the CNAME records to your DNS.
Once added, please let Arlo Support (or your CSM) know so we can complete the setup.
Step 3: Arlo verifies the records
Once the records have been added to your DNS, Arlo can verify the records have been added correctly and finalise the DKIM setup.
The records may take up to 24 hours to be propagated through your DNS so it may take a day or two to verify the records.
If you do not wish to add SPF and DKIM records to allow Arlo to send emails on your behalf, the other available option is to use Arlo's generic email address, noreply@trainingplatform.net, as the From address of your emails, and set the Reply to address as your administrative contact email.
If you want to know more about setting your sender details, please read our Configure your key settings help article.