SSL certificates allow HTTPS to be enabled for a custom domain used in a CNAME. Our new SSL certificates feature allows you to upload your own SSL certificate so that you can still brand your links with your company's domain name instead of the ClickDimensions domain while still allowing for a secure connection via HTTPS. This is currently available for use with Web Content CNAMEs and multiple SSL certificates can be uploaded if you make use of multiple CNAMEs on different domains.
Uploading a new SSL certificate
Navigate to Settings and Support > ClickDimensions Settings > SSL Certificates in CRM.
This will open the SSL Certificates area where you can upload your certificates:
Clicking the Upload File option will allow you to select an SSL certificate to upload.
SSL Certificate Setup and Requirements
First, you will need to set up a CNAME within your domain provider's settings. For all regions, this CNAME needs to point to: cd-analytics.azurefd.net
Once this is done, you will need to generate the SSL certificate and upload this certificate using the SSL Certificates option on the ClickDimensions Settings page as shown above. Wildcard certificates are supported, however you must use a CNAME that points to cd-analytics.azurefd.net and does NOT contain with a wildcard character in the domain field (ex. *.clickdimensions.com cannot be used as the domain). In addition, the certificate's validity period must be greater than 30 days, and the currently supported file types for your SSL certificate are:
- .pem (can only have one certificate and private key included)
You can then enter your certificate's password (if it has one set) to complete the upload process. Once you have filled in these fields, you will then have the option to 'Confirm and Add' your certificate.
After the SSL certificate has been uploaded, you will then need to create a new Domain record for your CNAME in CRM for this process to complete properly. Please note that this step must be done after uploading the certificate as this will allow the certificate to process on our end. You should then be able to use HTTPS with Web Content using this CNAME 1 hour after this process completes.
Updating SSL certificates
Once you have at least one uploaded certificate, the SSL Certificates screen will also update:
You will then be able to add a Notification Email that will be alerted 30 days before your certificates are about to expire. You will also have the options to Remove this certificate or use the Replace File option to change the certificate itself. If you have additional certificates that you would like to use, then you can use the Add Another SSL Certificate option to create another entry.
Removing SSL Certificates
If you would like to remove a certificate, then you will first need to go into your domain provider's settings and remove the CNAME from there. Once that CNAME entry is removed, you can then navigate back into Settings and Support > ClickDimensions Settings > SSL Certificates and click the Remove button on the corresponding SSL certificate.
Please note that if you have uploaded the same SSL certificate into multiple environments, then removing the SSL certificate from one environment will remove the certificate from ALL environments. Due to this, you may want to consider using a different set of certificates for the environments were applicable and check each of your environments after removing a certificate to ensure that all of the appropriate certificates are still present.
Please note: We bypass restrictions of subject line and manual upload certificate but we are working to check for alternative subject name.
Which Certificate Authorities do we allow?
The allowed authorities are listed here. These certificate authorities are determined by Azure FrontDoor, which is a Microsoft Service utilized by ClickDimensions for the creation of this service.
If I already have an existing Domain record in CRM with a Web Content alias, do I still need to create a new Domain record?
No, you do not need to create a new Domain record. Instead, you can simply purchase a certificate for that existing alias, point that CNAME alias to the cd-analytics.azurefd.net URL in your domain provider's settings, and then upload your certificate using the SSL Certificate option on the ClickDimensions Settings page.
|Feature Added: 11.3.0|
|Feature Updated: 11.3.0|
|ClickDimensions Version Needed: 11.3.0|