Using a Custom Domain Name

Suggest Edits

1. Contact us

Before contacting us, you will want to know the domain that your company will use, for instance https://map.mycompany.com. Your URL must end with your company's domain name, however additional characters may be added to the “maps.” section of the url. We are not able to accommodate slashes at the end of the URL.

With a name in mind, contact us and let us know that you would like to white label your company's Wayfinder on Web product. Your Atrius representative will then guide your team through two prerequisite steps for using a custom domain name.

2. Help us secure your Wayfinder on Web product using HTTPS

In order for your customers to access your Wayfinder on Web product using HTTPS, we need to install an SSL certificate on your instance of the Wayfinder on Web product. We can generate that SSL certificate in three different ways:

A) DNS Validation (preferred)

This method works by having you create special DNS records that allow our cloud service provider, AWS, to automatically validate domain name ownership so that it can automatically generate an SSL certificate.

This is our preferred method because it allows for automatic renewal of the SSL certificate, which would normally expire after one year. Other methods will require manual action to keep the SSL certificate up to date.

Choose this method if:
• you want your SSL certificate to automatically renew every year

Next Steps
• Inform us that you'd like to use DNS Validation for your SSL Certificate
• An Atrius representative will reach out to you with the specific DNS records to be created to validate domain ownership
• Contact your systems administrator to create the DNS records

B) Email Validation

This method works by having you validate domain name ownership by responding to an email sent by AWS. Specifically, AWS will send emails to the following addresses:

  • administrator@your_domain_name

  • hostmaster@your_domain_name

  • postmaster@your_domain_name

  • webmaster@your_domain_name

  • admin@your_domain_name

Choose this method if:
• you are able to contact the person with ownership of any of the above email aliases

Next Steps
• Inform us that you'd like to use Email Validation for your SSL Certificate
• An Atrius representative will reach out to you when the automated email with validation link has been sent
• Contact your systems administrator informing them to validate domain name ownership by clicking the link in the email

C) Certificate Signing Request (CSR) (your own Certificate)

This method works by an Atrius representative providing you with a "Certificate Signing Request", which you can then use to Generate your own SSL Certificate through any standard procedures that your Company practices.

Choose this method if:
• your company cannot perform DNS or Email validation
• your company enforces a standard procedure for creating SSL certificates

Next Steps
• Inform us that you'd like to proceed with a Certificate Signing Request
• An Atrius representative will reach out to clarify any additional information required to create the certificate signing request
• An Atrius representative will reach out to provide you with the certificate signing request
• Pass the certificate signing request along to when following your company's standard procedure for SSL certificate creation.
• Send the SSL certificate back to your Atrius representative

3. Add a Canonical Name Record to Company's Domain Name System

Last, we will need to redirect traffic from your company domain e.g. map.mycompany.com to the map which is hosted on our domain. This will require your system administrators to add a new Canonical Name (CNAME) record to your company's DNS. The CNAME record's value will be provided by us. In the extract below, we demonstrate what your CNAME record might look like.

NAME              TYPE   VALUE
----------------------------------------------
maps.company.com.  CNAME  xyz.maps.atrius.com.

Next Steps

  1. An Atrius representative will reach out with the proper DNS record name and value

  2. Work with your system administrators to get the DNS record created

Updated 7 months ago