A domain alias allows you to create a record in your company's DNS zone (a CNAME) for a status dashboard (for example, status.acme.com). This allows you to host the status dashboard over a domain that you own, and that is familiar to your customers and users.
Format
A domain alias may contain any alphanumeric character as well as '-' and '.', may be up to 75 characters long, and may have up to 4 subdomains (e.g. status.sf.na.acme.com). Domain aliases must be globally unique within StatusDashboard, across all customer accounts.
Setup
Domain aliases require custom configuration to be performed by the StatusDashboard support team. If you are interested in creating or updating a domain alias for a status dashboard, please contact customer support for assistance. Once the StatusDashboard support team has configured your status dashboard domain alias, you can view and validate the configuration by navigating to Status Dashboards > Edit > Dashboard Options > Dashboard Update > Domain Alias. Once you confirm that the domain alias configuration is correct, you will need to create a CNAME record in your organization's DNS zone (the zone that matches the domain alias) and point it at one of the following hostnames:
|
Option |
Description |
|
The status dashboard subdomain (e.g. acme.statusdashboard.com) |
As long as you do not change your subdomain URL, this is acceptable. |
|
dbs.statusdashboard.com |
This hostname will never change and is the best way to map your domain alias to the StatusDashboard network. |
Please do not create an A record that points to the IP address of the status dashboard subdomain URL or dbs.statusdashboard.com - you must create a CNAME. Our IP addresses are subject to change periodically and your dashboard page could become unavailable if you create an A record instead of a CNAME record. If you have any questions about the proper setup of your domain alias, please contact our support team.
Example DNS Setup
The following dig DNS query shows the domain alias status.acme.com mapped to the statusdashboard subdomain acme.statusdashboard.com (which is automatically mapped to dbs.statusdashboard.com).
[jon@localhost /]# dig status.acme.com ; <<>> DiG 9.9.4-RedHat-9.9.4-18.el7_1.1 <<>> status.acme.com ;; global options: +cmd ;; Got answer: ;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 27529 ;; flags: qr rd ra; QUERY: 1, ANSWER: 11, AUTHORITY: 0, ADDITIONAL: 1 ;; OPT PSEUDOSECTION: ; EDNS: version: 0, flags:; udp: 4000 ;; QUESTION SECTION: ;status.acme.com. IN A ;; ANSWER SECTION: status.acme.com. 43121 IN CNAME acme.statusdashboard.com. acme.statusdashboard.com. 3521 IN CNAME dbs.statusdashboard.com. dbs.statusdashboard.com. 3521 IN CNAME d33ge7nifrjjkv.cloudfront.net. d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.121 d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.157 d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.160 d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.203 d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.12 d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.56 d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.64 d33ge7nifrjjkv.cloudfront.net. 2 IN A 54.230.87.70 ;; Query time: 2 msec ;; MSG SIZE rcvd: 281 [jon@localhost /]#
SSL
All domain aliases are served exclusively over SSL - this setup requires the addition of the domain alias to one of the StatusDashboard SAN SSL certificates. If you are interested in serving your status dashboard over a domain alias, the StatusDashboard support team will assist you with the addition of your domain alias to one of our SAN SSL certificates. This process typically takes several days, and does not cause any disruption to your status dashboard.