Tools

How to import PFX SSL certificate in Web Help Desk(WHD) with Portecle

This article shows how to import a PFX SSL certificate in the Web Help Desk application using the Portecle tool.

First published date

4/13/2020 6:31 PM

Last published date

2/4/2025 12:50 AM

Overview

This article provides the instructions on how to import an SSL certificate in PFX format into the Web Help Desk application using the Portecle app embedded with Web Help Desk.

Product section

Web Help Desk

Resolution

For Windows and MAC deployments:
 

  1. Login to the Web Help Desk server
  2. Navigate to C:\Program Files\WebHelpDesk\ and run Portecle.bat
  3. Right-click and select Run as administrator


  1. Select File > Open Keytore File
  2. Browse C:\Program Files\WebHelpDesk\conf\ and select keystore.jks
  3. Enter the password.  The default password is changeit
    • If the password has been changed, you can see the keystore password inside the whd.conf file found in C:\Program Files\WebHelpDesk\conf\whd.conf.
# Keystore settings (for SSL connnections)
KEYSTORE_PASSWORD=changeit
  1. Right-click tomcat
  2. Click Delete


  1. Select Tools > Import Keypair
  2. Browse to the P12 or PFX file
  3. Enter the P12 / PFX password
  4. Click OK


  1. Change the alias name to tomcat
  2. Enter the keystore password as changeit

   

  1. Select File > Save Keystore > overwrite the existing keystore file.

  1. Select Tools > Set Keystore Password
  2. Enter changeit
  3. Save the changes

 

  1. Right-click tomcat
  2. Click Set Password
  3. Enter changeit
  4. Save the changes

 

  1. Navigate to C:\Program Files\WebHelpDesk\
  2. Right-click whd_stop.bat > Run as administrator
  3. Right-click whd_start.bat > Run as administrator

 


Confirm certificate installation using Portecle

 


For Linux deployments:

1. Get a copy of the keystore.jks file inside the server located in /usr/local/webhelpdesk/conf folder and put it on a Windows or MAC machine. WinSCP or other FTP clients can be used to copy the file.

2. Download and install Keystore Explorer in the Windows or MAC machine.
https://keystore-explorer.org/downloads.html 

3. Follow the steps above (for Windows) as the Kesytore Eexplorer and Portecle interface and options are very similar.