Skip to main content

Add SSL to your MindTouch site (MT4)

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. "", "")

Obtain 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. 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:

  • SSL Certificate
  • Certificate Authority (CA) bundle or intermediary certificates 

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

NOTE: If you are using the older F1 Contextual Help implementation, a specific Subject Alternate Name (SAN) SSL certificate is required. The Contextual Help Touchpoint requires an SSL, though any SSL type can be utilized.

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 F1 Considerations

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

  • Was this article helpful?