Skip to main content

FV Decipher Support

All the topics, resources needed for FV Decipher.

FocusVision Knowledge Base

Setting Up a Domain Alias (CNAME)

Overview

A "CNAME"  (Canonical Name) is how we colloquially reference a domain alias. It allows an alternative domain name to be used to either access FocusVision hosted surveys or branded email sends. A CNAME can be created using a CNAME Record (for subdomains) or an A Record (for apex domains).

The setup presented here does not support secure connections and would only be used for accessing web pages over a nonsecure connection. To set up a secure connection, please reach out to your main FocusVision contact.

1: Setting Up a CNAME

You need a current domain to setup a CNAME. If you do not own a domain, you can purchase a domain from a third-party vendor such as NamecheapA CNAME record can be setup as secure or non-secure depending on whether certificates are setup.

There are two ways to setup a CNAME:

CNAME Record - This is the easiest way to set up a CNAME. When a CNAME Record is set up, it redirects the current domain to the target domain and uses the same DNS settings as the target domain.

A Record - An A Record should be used when you can not set up a CNAME Record. For example, because your DNS system does not support CNAME Records, or because you are setting up an apex domain (domain.com) rather than a subdomain (customer.domain.com).

1.1: Using a CNAME Record

A CNAME Record should match the subdomain part of a current domain and its domain should point to the server where its surveys are hosted. To create a CNAME using a CNAME Record, add your CNAME Record as the host and your FocusVision server as the target.

For example, if you wanted to create a CNAME for customer, whose surveys are located on the main US server, the CNAME would be customer.domain.com and it would point to v2.decipherinc.com.

 

Main Decipher Servers by Region:

US Server

v2.decipherinc.com

EMEA Server

uk.focusvision.com

APAC Server

apus.decipherinc.com

1.2: Using an A Record

To set up an A Record, point your domain to the IP where your surveys are hosted. Please reach out to your main FocusVision contact in order to get the required server IP.

2: Sending Emails from a CNAME

By default, if you send your email out using your CNAME, it will be put into an invisible envelope and sent out as invite@decipherinc.com. If you choose not to use the invisible envelope and plan on sending emails with your CNAME, you will need to set up MX, SPF, DKIM, and DMARC records. DKIM and DMARC need to be added as either CNAME Records or as TXT Records. While MX and SPF may be automatically inherited in a CNAME Record or may need to be set up as individual MX and TXT Records (respectively), you can not setup MX/TXT Records and may need to use an additional subdomain specifically for sending emails if you have setup a CNAME Record for survey links.

Once the CNAME has been setup, please send it to FocusVision support in order to verify that setup has been done correctly and to authorize Campaign Manager to send from that domain without using the invisible envelope of invite@decipherinc.com.

When DKIM and DMARC are both set up as CNAME Records, they should not be setup instead of the previous CNAME Record, and should not conflict with any CNAME Record that already exists, since it should be added onto a new subdomain setup.

2.1: DKIM

2.1.1: CNAME

To set up DKIM using a CNAME Record, create an additional CNAME Record and add it to your subdomain.

For example, for customer.domain.com, you would need to set up main2016._domainkey.customer.domain.com and target main2016._domainkey.decipherinc.com.  

Example for customer.domain.com:

Domain

Value

main2016._domainkey.customer

main2016._domainkey.decipherinc.com

2.1.2: TXT

To setup DKIM using a TXT record, create an additional TXT Record on an additional subdomain of main2016._domainkey. So if it was for an apex domain, you would set up main2016._domainkey, but for a subdomain like customer.domain.com, you would set up main2016._domainkey.customer. The TXT Record value should consist of the below:

v=DKIM1;
p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4k0UdBCrCAq0+CBoT5UXODT4ovb5
KItrblf7nwh7D9jsP2DBZnXW1o1ji/l8Ap9P4arLYx/7Ii8YLNTBCC3zzHzSo9kXwsur7k0t3H
2s6YzrdFPjqDQMSKnDcZRCfEfYumjxFNyZKnhQETkdCuUn7zxvz4mS25Zv1mLRlKHU//2assXY
qvLPLOHcqkPsNZEVIcS0mzBNNpNLtDsSTP2MebRdpRwwz90OxrY7l7Uee1P0+nuQHeCP829vNh
rplVqDAXu61WG9uIJti2KhbjuHXT0ujio0e63qQnENabQlPAtY7OoZtgP0x9O5FhboffGxkVf+
fwHptTVJbsvm8dVDYQIDAQAB

Example for customer.domain.com:

Domain

Value

main2016._domainkey.customer

v=DKIM1; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4k0UdB
CrCAq0+CBoT5UXODT4ovb5KItrblf7nwh7D9jsP2DBZnXW1o1ji/l8Ap9P4ar
LYx/7Ii8YLNTBCC3zzHzSo9kXwsur7k0t3H2s6YzrdFPjqDQMSKnDcZRCfEfY
umjxFNyZKnhQETkdCuUn7zxvz4mS25Zv1mLRlKHU//2assXYqvLPLOHcqkPsN
ZEVIcS0mzBNNpNLtDsSTP2MebRdpRwwz90OxrY7l7Uee1P0+nuQHeCP829vNh
rplVqDAXu61WG9uIJti2KhbjuHXT0ujio0e63qQnENabQlPAtY7OoZtgP0x9O
5FhboffGxkVf+fwHptTVJbsvm8dVDYQIDAQAB

2.2: DMARC

2.2.1: CNAME

To set up DMARC using a CNAME Record, create an additional CNAME Record and add it to your subdomain. For example, for customer.domain.com, you would need to set up _dmarc.customer.domain.com and target _dmarc.decipherinc.com.

Example for customer.domain.com:

Domain

Value

_dmarc.customer

_dmarc.decipherinc.com

2.2.2: TXT

To setup DMARC using a TXT record, create an additional TXT Record on an additional subdomain of _dmarc. So if it was for an apex domain, you would set up _dmarc, but for a subdomain like customer.domain.com, you would set up _dmarc.customer. The TXT Record value should consist of the below:

v=DMARC1;
p=none; rua=mailto:re+ogsp7vgfela@dmarc.postmarkapp.com;
ruf=mailto:auth-reports@decipherinc.com; adkim=r; aspf=r

Example for customer.domain.com:

Domain

Value

_dmarc.customer

v=DMARC1; p=none; rua=mailto:re+ogsp7vgfela@dmarc.postmarkapp.com;
ruf=mailto:auth-reports@decipherinc.com; adkim=r; aspf=r

2.3: MX

To setup an MX record, create an additional MX Record on the domain. The MX record value should be mail1.decipherinc.com. It is recommended to set the MX record to a priority of 10 but it can be another value if needed.

Example for customer.domain.com:

Domain

Priority

Value

customer

10

mail1.decipherinc.com

2.4: SPF

To set up SPF, create a TXT record on your domain with a value of v=spf1 include:bulk.decipherinc.com ~all. If an SPF record is already setup for your domain, you should only need to append include:bulk.decipherinc.com ~all.

Example for customer.domain.com:

Domain

Value

customer

v=spf1 include:bulk.decipherinc.com ~all

2.5: From Address and tracking Bounce Backs

If the invisible envelope is not being used, the From address specified in Campaign Manager must be from the domain setup to send emails and be a valid email. For example, if DKIM/DMARC/SPF/MX are setup on emails.domain.com the From address would have to be "something@emails.domain.com", even if the survey link is survey.domain.com.

In order for the system to track bounce backs when not using the invisible envelope, you will need to set up the inbox that your From address is using to forward emails to invite@decipherinc.com. Otherwise bounce backs will not appear in the Field Report.

2.6: Checking Deliverability

Once everything has been setup to send your domain to not use the invisible envelope, it is recommended to check deliverability of your email and domain. This can be achieved by sending to multiple different email service providers like Google, Microsoft, and Yahoo. You could also use a third party service such as GlockApps.

3: Checking the Setup

3.1: Domain Tools

The easiest way to check the setup of your new CNAME is to use the "Lookup" option within the Decipher Domain Tools toolbox. Simply enter your CNAME, and press Enter to begin the check:

If SURVEY/SPF/MX/DKIM/DMARC are all highlighted green, then your CNAME has been set up properly and is able to send emails. If any of these fields are missing or in red, then you will need to review your setup.

Decipher Domain Tools was designed for internal testing, and is not customizable. Occasionally, the tool may not be able to pick up the DNS settings of your CNAME. In those cases, you can use a third party DNS lookup tool like MX Toolbox.

Verifying DKIM and SPF requires additional steps, which are outlined below.

3.2: Alternative Checking

3.2.1: DKIM Checking

For DKIM, your selector should be main2016 when checking. If you are using MX Toolbox’s DKIM Record Lookup Tool, the domain name would be your CNAME, and the selector would be main2016:

3.2.2: SPF Checking

SPF should be checked with the SPF Policy Tester Page. To check your SPF, enter one of the following FocusVision IP addresses under "IP Address":

  • 204.13.11.48
  • 204.13.11.51
  • 65.212.180.36
  • 65.212.180.75
  • 204.13.11.36
  • 195.14.73.86
  • 195.14.73.87

Next, enter invite@cname_domain (example: invite@client.domain.com) under the sender address. If your SPF is configured correctly, a green "pass" displays at the end of the text:

If there are problems with the SPF configuration, a blue block may display at the end of the text instead:

In this case, your SPF has been configured incorrectly and your setup will need to be reviewed.

3.2.3: MX and DMARC

To check your MX and DMARC, simply enter your domain name in the MXtoolbox. The MX lookup can be found here and the DMARC lookup can be found here.

4: Enabling the CNAME

After verifying your CNAME configuration, send the CNAME to your main FocusVision contact or support team to add it to your company page.

Once your CNAME has been added to your company, you can use it for masking survey URLs. To mask a survey URL for a project, add the specific CNAME to the CNAME field in the "Field Settings" window and click "Save":

  • Was this article helpful?