Setting a custom domain name for a site (host mapping)

This article will show you how to add a custom domain name to your site. What does this mean? If you have a domain (e.g. www.mydomain.com) and a site on ScreenSteps (e.g. https://myaccount.screenstepslive.com/s/1) you could point https://help.mydomain.com to your ScreenSteps site.

This article discusses setting up an SSL certificate with a custom domain so users can securely connect to your ScreenSteps content. SSL certificates for custom domains are supported on Small Business plans and above. If your company has a Non-Profit plan then SSL is support on NPO Medium and above.

Can I setup ScreenSteps as a subdirectory on my domain?

Some customers ask if ScreenSteps can be set up as a subdirectory on their site, for example http://www.mydomain.com/knowledgebase. This isn't possible. You will have to use a subdomain such as http://kb.mydomain.com if you want to use a custom domain with ScreenSteps.

Set up a CNAME record with your DNS provider

Before you can add a host mapping record, you must create a CNAME DNS record that points your custom domain name to ext.screensteps.com. Your system administrator should be able to help you with this.

Example of creating a CNAME

Here is an example of creating a CNAME record in DNS Made Easy. The process will be similar in other DNS provider interfaces.

In the example below, readers will go to help.mydomain.com to view your ScreenSteps content. help.mydomain.com points to ext.screensteps.com which points to the ScreenSteps server where your content is hosted.

Create Hostname, Record Type, Target Host > Save

Some DNS provider interfaces require you to add a . to the end of ext.screensteps.com while others do not. DNS Made Easy requires the ..

Add the custom domain to one of your ScreenSteps sites

Navigate to Settings > Domain Settings for one of your sites

After you create the CNAME DNS, go to Settings for a site in your ScreenSteps account.

Navigate to the Domain Settings section and enter your custom domain in the Custom domain name field. Click Update.

IMPORTANT: Do not include the scheme in the custom domain name. For example, do not prefix the domain name with http:// or https://.

Verify DNS settings

After clicking Update ScreenSteps will try to verify that the CNAME DNS settings for the domain you entered are configured properly. If they are then you will see the DNS successfully verified button appear and you can move on to setting up SSL so that readers can securely connect to your site.

If your CNAME DNS settings are not correct then you will see the message below. Double-check your settings with your DNS provider and then click the Verify DNS button to perform the check again.

One way to confirm that your CNAME record is pointing to ext.screensteps.com is to visit a service such as https://www.whatsmydns.net/#CNAME and enter your custom domain name. The service will tell you if the custom domain name is pointing to the right place.

Enable SSL

Before you start using your custom domain name you should enable SSL. This will allow your readers to securely connect to your ScreenSteps content using your custom domain. In our example case, it would allow your browser to securely connect to https://help.mydomain.com.

You have two options for enabling SSL for a custom domain.

  1. Allow ScreenSteps to manage the SSL certificate
  2. Upload your own SSL certificate

If you click Enable ScreenSteps-provisioned SSL then ScreenSteps will automatically generate an SSL certificate for your custom domain using the LetsEncrypt service. ScreenSteps will also renew the certificate as needed so that you never have to worry about it expiring.

If you click the Upload a custom SSL certificate button then you will provide a public certificate and chain in PEM format along with the private key in PEM format. After entering the certificates click the Update button.

Mouse over the i icons next to the Public certificate & chain and Private key fields for examples of what the certificates should look like.

SSL managed by ScreenSteps example

This is an example of what you will see after successfully setting up an SSL certificate that is managed by ScreenSteps. It tells you who issued the certificate as well as the date by which the certificate will be renewed.

Custom SSL example

This is an example of what you will see after successfully setting up a custom SSL certificate. It tells you who issued the certificate as well as the expiration date.

Make sure that you update the SSL certificate in ScreenStep prior to the expiration date.

0 Comments

Add your comment

E-Mail me when someone replies to this comment