DNS Configuration for Cangooroo Front

DNS Configuration for Cangooroo Front

In this article we'll see how to perform the DNS configuration.

First, let's understand what DNS is: the simplest way to explain DNS is to say that it translates names (or URLs, like google.com) into IP addresses. So when you type "google.com" into your browser, it calls a DNS server and translates it into http://172.217.9.14/, which is how you access the Google search page.

Why does it need to be configured? When we deliver the Cangooroo Front to any client, it has a unique URL, such as frontXYZ.cangooroodns.com.br, where frontXYZ is the unique identifier for your front.

As a Cangooroo client, you probably want to use your own domain, such as www.yourcompany.com, and that's why you need to configure DNS for the domain "yourcompany.com".

With this information, you'll need to include this domain in your Cangooroo setup. The first step is to make sure our support team has been informed of the desired URL so the front can be properly configured in the Cangooroo system.

There are different requirements depending on your setup and goal. If you want the main page to be a subdomain of your domain, you just need to add a CNAME configuration.

Subdomains
For example, if you want to configure b2b.yourcompany.com as the URL for your main page, simply add a CNAME record in your DNS management tools as follows:

type: CNAME
name: b2b
value: frontxyz.cangooroodns.com.br

But if you want your root address, such as yourcompany.com, to be the URL for your main page, there are some additional configurations:

• Check whether your DNS tool/system supports "CNAME flattening."
• Check whether you can redirect the root domain to another domain.

General configuration for the root domain

In general, if you're not using Cloudflare, we recommend the following configuration for the root URL:

• If possible, redirect your root domain (e.g., yourcompany.com) to www.yourcompany.com.
• If that's not possible, use your hosting service to create your own redirect page. Some references here and here.
• Create a CNAME record pointing your www to frontxyz.cangooroodns.com.br.

Within a few hours, you'll be able to access your main page using yourcompany.com and www.yourcompany.com.

We've also put together step-by-step guides for some of the most common domain providers, such as Cloudflare and GoDaddy. Check them out below:

Cloudflare Configuration

This instruction is for those who have already set up their domain on Cloudflare. If that's not your case, please create an account (a free one works) and set up your domain there. We don't offer support for that setup, and you'll need to follow Cloudflare's official instructions to do so. Then, follow the instructions below.

Subdomains

Let's assume you have your main URL as frontxyz.cangooroodns.com.br and want to use it as the URL b2b.yourcompany.com. In that case, you'll be setting up a subdomain of your domain. It's a simple CNAME configuration — just follow these steps:

1. Go to your domain's settings in Cloudflare.
2. Go to the DNS settings.
3. Add a new CNAME record.

• Type: CNAME
• Name: b2b
• Value: yourcompany.com

Within a few hours, you'll be able to access your main page using the URL b2b.yourcompany.com

Root domain

If you want to set up the main page on your root domain, follow the instructions below:

1. Go to your domain's settings in Cloudflare.
2. Go to the DNS settings.
3. Add a new CNAME record (check whether there's already another record named "@" and delete it).

• Type: CNAME
• Name: @
• Value: frontxyz.cangooroodns.com.br

4. Add another CNAME record.

• Type: CNAME
• Name: www
• Value: yourcompany.com

Within a few hours, you'll be able to access your main page using yourcompany.com and www.yourcompany.com.

For both configurations, we recommend enabling the proxy option.

GoDaddy Configuration

This instruction is for those who have already set up their account and purchased a domain on GoDaddy. If that's not your case, please create an account and set up your domain there. We don't offer support for that setup, and you'll need to follow GoDaddy's official instructions to do so. Then, follow the instructions below.

Subdomains

Let's assume you have your main URL as frontxyz.cangooroodns.com.br and want to use it as the URL b2b.yourcompany.com. In that case, you'll be setting up a subdomain of your domain. It's a simple CNAME configuration — just follow these steps:

1. Go to your DNS settings.
2. Add a new CNAME record.

• Type: CNAME
• Host: b2b
• Points to: frontxyz.cangooroodns.com.br
• TTL: 1/2 h

Within a few hours, you'll be able to access your main page using the URL b2b.yourcompany.com.

Root domain

If you want to set up the main page on your root domain, follow the instructions below:

1. Go to your DNS settings.
2. Find the forwarding section and configure it as follows:

• Forward to: https://www.yourcompany.com
• Forward type: Permanent (301)
• Settings: Forward only

3. Add a new CNAME record.

• Type: CNAME
• Host: www
• Points to: frontxyz.cangooroodns.com.br
• TTL: 1/2 h

Within a few hours, you'll be able to access your main page using yourcompany.com and www.yourcompany.com.

We offer paid advanced support separately if you need help carrying out this procedure, but if you have any questions, feel free to reach out to our support team and we'll do our best to help.