Problem

How do I install an SSL Certificate onto a JSCAPE MFT Server?

Solution

This knowledge base article will describe the process of installing your QuoVadis certificate onto a JSCAPE MFT Server in 3 parts.  This article assumes that you have already created a pending private key in your Key Manager.

Part I - Creating the Certificate Bundle

Part I describes the process to create the Certificate Bundle that you will need to ensure that your certificate is trusted in all browsers correctly.

1. First you must obtain your certificate in PEM format.  By default, QuoVadis issues certificates in this format.  You must convert this file if you have your SSL certificate in a different format.

Note: QuoVadis provides a conversion tool at https://pkiwidgets.quovadisglobal.com/pkiwidgets/convertCert.aspx.


2. Download the JSCAPE_MFT_qvsslicag2_bundle.txt file.


3. Open the both your certificate and the JSCAPE_MFT_qvsslicag2_bundle.txt using notepad (or a similar simple text editor).


4. Copy the entire contents of your certificate and paste them onto the line named <Highlight this line and paste in your certificate here>, replacing it.  Be sure to include the "-----BEGIN CERTIFICATE-----" and "-----END CERTIFICATE-----" lines.

The file should now look something like this:

-----BEGIN CERTIFICATE-----
(The certificate you pasted)
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
(QuoVadis Global SSL G2)
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
(QuoVadis Root CA 2)
-----END CERTIFICATE-----


5. Once you have made these changes, save this new file you have created.

Part II - Installing the Certificate

Part II walks you through the process of taking the certificate bundle file you created in Part I and importing it into your private key.

1. Start off by opening Key Manager.  You can do this by navigating to File and then selecting the Key Manager file from the main menu.


2. When the Key Manager dialog appears, click on the Server Keys tab at the top.


3. Click on and highlight the private key that you created the CSR from in the left list.


4. Click on the Import Certificates button at the bottom.


5. In the Import Certificates window, click on the Browse button and navigate to the new file that you created at the end of Part I.


6. Leave the File Password field blank.


7. Leave the Certificates alias in file field blank


8. Click on the OK button.

Part III - Assigning the Certificate

Part III assigns the certificate for use so that it is visible to users when they browse to your website.

1. In the JSCAPE MFT Server Manager Settings, select the Web settings from the left-hand list.


2. Click on the Web tab at the top and drop down the Private key field to match the new certificate that you want to display on your website.


3. Restart the JSCAPE MFT Server services.