Skip to main content
MindTouch Success Center

Add SSL to your MindTouch site (TCS)

Written by James Valent
Director of Support at MindTouch

This article explains the steps that are needed to add an SSL to your MindTouch site. An SSL allows users to access your site over HTTPS:// and provides a secure level of encryption. This article is most relevant for content managersdevelopers and site owners.


SSL Considerations

Be sure to read about additional considerations for SSL implementation in MindTouch!


There are three steps required when implementing an SSL for a custom domain within your MindTouch site:

  1. Getting a Certificate Signing Request (CSR) from MindTouch
  2. Obtaining an SSL certificate
  3. Coordinating the domain name service (DNS) change

Getting a Certificate Signing Request from MindTouch

Before you can purchase a certificate, MindTouch will need to generate a Certificate Signing Request (CSR) so you can obtain a certificate that is guaranteed to work with our servers. In order to generate the CSR please provide MindTouch Support with the following information:

  • Country where your company is headquartered (e.g. "US")

  • Region (e,g, State, County, Province)  where your company is headquartered (e.g. "California")

  • Town or City where your company is headquartered (e.g. "San Diego")

  • Business or Organization Name (e.g. "ACME Corp.")

  • Department Name (e.g. "Documentation Team")

  • Valid E-mail Address

  • Domain names to associate with MindTouch (e.g. "", "")

Obtaining an SSL Certificate

Once you have obtained a Certificate Signing Request from MindTouch Support, you will then provide this to an SSL vendor to purchase your SSL.

In this case, you will need to purchase a Subject Alternate Name (SAN) SSL certificate. A SAN SSL certificate is required for configuring HTTPS connections to a custom domain within MindTouch. This SSL type is not the same as a wildcard or single domain SSL, which are not compatible with MindTouch.

There are many SSL vendors on the market that you can choose from. We recommend checking with your existing web hosting provider before using another third-party certificate authority.

Once you have purchased an SSL, you will need to provide the following items to MindTouch Support:

  • SAN SSL Certificate
  • Private Key
  • Certificate Authority (CA) bundle or intermediary certificates 

Once the SAN SSL certificate and associated files are in place, MindTouch Customer Success will coordinate the final steps to enable SSL on your site.

Coordinating the Domain Name Service Change

Before your site starts using the SSL certificate, you will need to coordinate a domain name service (DNS) change with your web or network administrator. If you are using an apex domain, please contact MindTouch Customer Success for the "A record" information you will need to complete the change-over, otherwise this DNS change requires an "CNAME record" be pointed to ''.

In order to minimize downtime associated with the DNS change, please contact MindTouch Support to coordinate the change, as a corresponding change will need to be made by a MindTouch employee to finalize the process. Prior to this process, we recommend you work with your web or network administrator to lower your DNS TTL (time to live) value as low as your DNS host will allow. This will help minimize additional delays associated with the DNS change. After the DNS change, you can then increase your TTL value as needed.

Additional Domain Change With F1

If you are using F1, you will need to make an additional CNAME record in your DNS entries for the "F1" version of your domain. For example, if you are going to use "" for your custom domain, then you need an additional "" record pointing to the main domain.

Additional F1 Considerations

Be sure to read about additional considerations for SSL implementation in MindTouch!

What's Next

Once the certificate is in place and you are using the new IP address, traffic that goes over http:// to your site will automatically redirect to use https:// so you users do not have to change their bookmarks or browsing behavior.

  • Was this article helpful?