How to install .pfx certificate manually in ServiceDesk Plus MSP version 10.5 and above

How to install .pfx certificate manually in ServiceDesk Plus MSP version 10.5 and above


The below steps are applicable for version 10.5 and above. For .pfx certificate installation in version 9427 and below, follow the steps here

NOTE: Please take a server snapshot before following the steps given below

A PKCS12 (.pfx) certificate stores the RSA keys and the SSL certificate in a single encrypted file.
Follow these steps to install the certificate manually:

1. Stop the application. 
2. Copy the PKCS12 (.pfx) file to ManageEngine\ServiceDeskPlus-MSP\conf\.
3. Switch the application to the secure mode by changing the webserver port to 443 by following the below steps 

3a. Stop the application 
3b. Open Command Prompt as Admin
3c. Go to ManageEngine\ServiceDeskPlus-MSP\bin
3d. Invoke command changeWebServerPort.bat [newportnumber] [Protocol http or https]

Refer below screenshot 




4. Go to  <installation directory>\conf\ and take a copy of server.xml  in a different location and open the server.xml file in a text editor present in <installation directory>\conf\.

  • Locate the Connector SSLEnabled="true" string, insert keystoreType="pkcs12" and replace the following attributes with values as shown:

 

Attribute 
Value
keystoreFile
conf/<your file name>.pfx
keystorePass

For versions earlier than 10.5, type your plain text password as is.

For versions 10.5 and later, paste the encrypted password.


The following screenshot displays the server.xml file after the required changes.


How to encrypt your password in ServiceDesk Plus MSP.

1. Open Command Prompt as Admin
2. Go to ManageEngine\ServiceDeskPlus-MSP\bin
3. For versions 10.5 and later, run:
encrypt.bat -a aes256 -v <your password>

The encrypted password will be displayed in the next line. 


5. Start the app

        New to ADManager Plus?

          New to ADSelfService Plus?

            • Related Articles

            • How to install SSL certificate of .PFX format for 9.4 builds

              Installing .PFX Certificate   .PFX is an extension for security certificate. It defines a file format that stores private keys (generated by your server at the time the CSR was generated) and public key certificate (your SSL Certificate provided by ...
            • How do I install SSL certificate for ServiceDeskPlus-MSP?

              Introduction ServiceDesk Plus - MSP can run as a HTTPS service. But it requires a SSL (Secure Socket Layer) Certificate signed by a valid Certificate Authority (CA). By default, on a first-time start-up, it creates a self-signed certificate. This ...
            • Some errors related to Python when trying to run a script in SDP MSP

              Case 1: We could see cases where users come across the below error when trying to execute scripts. This happens if the requests library is not imported.   In order to import the requests library in Python, follow the steps below: 1. Open cmd as admin ...
            • Outlook client configuration on the MSP Server

              This will help in cases where mail related actions works from the actual mailbox but not from MSP application. Logs would help us find the error trace that leads to the mail server. However, if this needs to be narrowed down further and to confirm ...
            • Error when generating reports in Linux installation

              Error: Sorry an error has occurred. It appears to be an issue related to the fonts. JDK recommends installing the font on the Linux machine. In general, OpenJDK installation packages do not include any font files by default. But automatically use ...