Table of Contents

Update certificate for OnPremise customers

Below is an explanation of how you can replace the certificate on your On-Premises server so that disruptions of the Boltrics software can be prevented. There are 2 ways to do this correctly: manually or with a script.

Manually

Step 1

  1. Install the certificate on the correct server
  2. Go to the start menu
  3. Search for "Manage Computer Certificates" (MMC) and open it
  4. In the console, you must install the certificate with a private key under "Local computer -> Personal -> Certificates".
  5. Import certificate in that location

Step 2

Go to IIS Manager, that way you can configure the certificate in the correct binding on the website "Microsoft Dynamics 365 Business Central Web Client".

Step 3

  1. After the steps above, it is important to set up the thumbprint of the new certificate within "Microsoft Dynamics 365 Business central".
  2. Open "Business Central Administration shell" as administrator and execute the following command for each server instance: Set-NAVServerConfiguration -ServerInstance server instance name -KeyName ServicesCertificateThumbprint -KeyValue Thumbprint certificate

Step 4

  1. For each port, it is important that the certificate is getting installed. You can do this through Windows command netsh.
  2. Open Command prompt (CMD) as administrator and type ‘netsh' and you will receive a netsh prompt.
  3. With http show sslcert, you can see all the ports that needs to be changed.
  4. For port 7147, 7148 and 7149 you can change the certificate with two commands that have to be executed for each port: ▪ http delete sslcert ipport=0.0.0.0: portnumber> ▪ http add sslcert ipport=0.0.0.0:< portnumber > certhash=thumbprint certificate appid={00112233- 4455-6677-8899-AABBCCDDEEFF}

Through a script

  • After the certificate is uploaded on the server (or followed step 1 under Manual), open PowerShell Command prompt as administrator and run script: BP_Set-CertificateBindings -ThumbPrint <Thumbprint certififcaat>
Note

As it concerns an On-Premise environment, updating the certificate is the responsibility of you as a customer. With this document, Boltrics helps you executing this task successfully.

Edit this page