...
You are configuring an SSL cert for the custom domain you want to use (E.g. app.mycustomdomain.com), not the *.mydevices.com URL that we provide to you. E.g. https://iot.yourcompany.com.
The cert can either be requested for free in AWS ACM, or a commercial SSL cert from GoDaddy or other SSL cert provider can be purchased and imported to ACM. We recommend using ACM free certs because it's free and it handles renewals automatically.
...
Open the request, and add the required DNS records to complete validation.
If you host their your domain in AWS too, then ACM can automatically add those records by clicking the appropriate button. If the domain is hosted elsewhere, those validation records must be added manually.
...
Once DNS records are ready, wait for CloudFront ACM to change status for the SSL cert to Issued.
...
➡️ Only when it's in Issued state the SSL Cert shows Issued should you proceed to Step 3 to create CloudFront distribution.
...
Default settings generally work, but below is a screenshot with the fields that we found need to be set / change from their default values. Everything else can stay unchanged.
☑️ Note: Origin domain is the domain from where CDN should pull the content from - please set it to the myDevices url for your app (e.g. yourcompany.mydevices.com). Refer to the URL shown in your white label settings in the IoT Console if unsure.
One note about the last highlighted field in the screenshot (Custom SSL certificate) - this is where the SSL cert for the custom domain appears if it was properly configured in ACM in Step 2. Although we have not selected anything in the screenshot (because we do not have SSL cert for our example domain), this field cannot be left empty - it must be set.
...
Step 3a - Create DNS record for your custom domain
Each CloudFront distribution has a unique domain name generated by AWS when the distribution is created. Create a CNAME record in your DNS provider, that points your custom domain at the unique hostname for your CloudFront distribution.
Example record:
Name: app.
...
mycustomdomain.com
Type: CNAME
Value: unique domain name generated by CloudFront
...
After creating the DNS record, allow at least 1 min for DNS to propagate and then verify if the record has been created properly using one of many DNS lookup tools like https://www.whatsmydns.net/ .
| Info |
|---|
Note: typically when making DNS changes, adding new entry propagates fast, but it’s not uncommon for modifications to an already existing record to take up to an hour or even longer. The time it takes for DNS change to propagate depends on how fast your provider applies your change and TTL (Time To Live) setting for your record. Explaining the concepts behind DNS is not part of this guide but please keep in mind, if DNS lookup tools indicate different results than you expect, double check your settings and then give it at least 1 hour to propagate. |
Step 4 - Disable Caching (Optional, Troubleshooting)
...
As a final step, please Notify Us and include the your details (your White label name, Custom URL being used) for your white label and let us know that you are done setting things up on your sidefollowing the configuration guide. We will then verify things are working and apply any final steps needed on our side to ensure your custom domain URL will work.
| Note |
|---|
Failure to do this step may result in problems such as Google Map API errors seen when your users use the dashboard. |