Time to read: 5 min.

The article covers the following topics:

The article explains how to add/change custom domains for Admin URL, Webmaster URL, and API URL only.

Read more about how to add/change custom domains for Tracking site URL here.

After getting access to your platform, Affise provides you with a set of default domain names. To find them, visit Settings section -> Tracking domains tab on your Affise admin panel.

Custom domains implementation

You have an option to add/change custom domains for Admin URL, Webmaster URL, and API URL:

The adding/changing custom domains includes 4 steps:

Step 1. Buying the custom domain on the hosting provider side

Check if your custom domain includes no less than three levels (ex. tracking.rocketcompany.com) and the domain name has at least 5 characters.

Step 2. Verifying the DNS configuration of the domain

Check if the CNAME record of your custom domain is set up to be an alias to your default domain name.

You can easily do that in one of the following ways:

  • Check it on your provider's side.

  • Check it on your own according to your operating system:


    For macOS:

If the OS of your computer is iOS, you need to navigate to Launchpad -> Other -> Terminal and use the ‘host’ command. Type the following command: 'host your domain', click on the Enter button. The response should contain the Affise default domain as an alias.

Ex.:

host admin.rocketcompany.com admin.rocketcompany.com is an alias for offers-rocketcompany.affise.com. offers-rocketcompany.affise.com is an alias for rocketcompany.affise.com. rocketcompany.affise.com has address (here your IP-address)

For Windows:

For Windows users, the command prompt (command line) is used.

Type the following command: 'nslookup your custom domain', click on the Enter button. The response should contain the Affise default domain as an alias.

Ex.:

C:\Users\HP>nslookup admin.rocketcompany.com ╤хЁтхЁ: router Address: (IP address) ╚ь : rocketcompany.affise.com Address: (IP address) Aliases: 
admin.rocketcompany.com offers-rocketcompany.affise.com

Step 3. Buying and verifying SSL certificate (optional)

Kindly note that Affise strongly recommends using trusted domain hosting services such as Verisign, DigiCert, Comodo, Godaddy, etc. We do not recommend using Free SSL certificates services such as Let's Encrypt, which can issue and result in browser warnings. Please, remember, that untrusted certificates setup may potentially cause traffic losses.

  1. Purchase SSL-certificate (.crt), Private Key (.key), bundle (.crt) for the domain name from the hosting side.

    • SSL-certificate (.crt) - a security protocol that secures data between two computers by using encryption.

    • Bundle (.crt) - the file that contains root and intermediate certificates. It's used in the procedure of SSL certificate implementation. ❗ We highly recommend adding a bundle file to ensure stable clicks flow. Some browsers can block clicks if the domain doesn't contain the bundle file.

    • Private Key (.key) - a separate file that’s used in the encryption/decryption of data sent between your server and the connecting clients.

  2. Ensure the files above match each other and the domain name itself. For this purpose, do one of the following:

    • Check it on your provider's side.

    • Check it on any open source as, for example, on this one:

https://www.sslshopper.com/certificate-decoder.html

If you've faced with several options of the Software existing when trying to get a certificate and key, choose one of the following options:

  • Apache

  • Nginx

Step 4. Contacting support and providing information about your domain and certificate

Notify Support Team:

1) Provide Support Team with the domain.

2) Provide Support Team with SSL certificate, Private Key, and Bundle.

3) Inform Support Team if you use Cloudflare.

FAQ

1) I set a custom domain with SSL some time ago, but now I want to renew the certificate with CloudFlare. Once this is done, do any further actions must be performed from Affise side or not?

No additional actions are required. Update the certificate, everything will work.

2) I set a custom domain with SSL some time ago, but now I want to renew the certificate. Once this is done, do any further actions must be performed from Affise side or not?

Yes, you should follow steps 3 and 4 of this article.

You may also find helpful the following articles:


Should you have any further doubts or questions on custom domains setup, feel free to contact our support team via support@affise.com operating 24/7 for your convenience.

Did this answer your question?