Bosch Building Technologies

    cancel
    Showing results for 
    Search instead for 
    Did you mean: 

    How to configure RPS API to work over HTTPS?

    Disclaimer: this guide is intended for Windows advanced users. Knowledge on Windows registry and batch files is highly recommended.

    If you don’t have knowledge on modifying the Windows registry, do not continue as any mistake can damage the operating system.

     

    Step-by-step guide

     

    This document consists of three parts:

    1. Import or create a certificate to the RPS computer
    2. Enable Https and configure the certificate binding
    3. Import the certificate into AMS server

     

    1. Import or create a certificate to the RPS computer

     

    You must use a SSL certificate, if you do not already have one, you can generate a self-signed certificate using a tool included with the RPS API installer folder.

    Access “SetupHttps” -> “Self-Signed_Cert”

    Central_Support_0-1632210846784.png

     

    To modify the properties of the certificate right click “CreateSslServerCert” and click Edit

    Central_Support_1-1632210894477.png

     

    In the –n line, replace “RPSPC” to the computer’s name where the RPS is installed.
    The –po line is the password assigned to the PFX file created. We recommend to input your own password.

    Central_Support_2-1632210937471.png

     

    After saving the file, run it (Do not run it as administrator). A prompt to create a password will appear, this to secure the private key of the certificate, this is not required but is recommended.

    Central_Support_3-1632210970785.png

     

    Three files are now created: the certificate, the private key, and the PFX file that contains both files.

    Central_Support_4-1632211000923.png

     

    To install the certificate in the RPS computer open the PFX file. In the Certificate Import Wizard, Select Local Machine and click next.

    Central_Support_5-1632211046331.png

     

    Under File to Import, verify the correct path and file name are populated and click next

    Central_Support_6-1632211091253.png

     

    Type the private key password created. And click next

    Central_Support_7-1632211128635.png

     

    Choose the Certificate store “Personal” and click next

    Central_Support_8-1632211164238.png

     

    Click Finish

    Central_Support_9-1632211203195.png

     

    2. Enable Https and configure the certificate binding

     

    To enable Https first stop the RPS API service.

    Open Services from the Start Menu

    Central_Support_10-1632211341257.png

     

    Select Bosch RPS API Service and click the stop button

    Central_Support_11-1632211390169.png

     

    Open the Registry from the start menu

    Central_Support_12-1632211429062.png

     

    Navigate to “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Bosch\RPSAPI\Setup”. Modify the value of “EnableHTTPS” from 0 to 1.

    Central_Support_13-1632211503506.png

     

    To create the certificate binding the following files are available within the SetupHttps folder:

    • Setup_HTTPS_RPSApi.ps1 (MS PowerShell)
    • Setup_HTTPS_RPSApi.bat (batch file)

    In this guide we will use the batch file.

    Right click the batch file and click edit

    Central_Support_14-1632211553885.png

     

    Copy the thumbprint of the certificate used: Open the certificate, go to Details tab and scroll down to Thumbprint.

    Central_Support_15-1632211604023.png

    Paste the thumbprint next to certhash=

    Central_Support_16-1632211647909.png

     Note: if RPS API is not running in port 9000, change the port number in the batch file.

     

    After saving the batch file, run it as administrator. Successful messages should appear now.

    Central_Support_17-1632211696205.png

     Start the Bosch RPS API Service.

     

    3. Import the certificate into AMS server

     

    Copy the certificate file and paste into the AMS server

    Right click the certificate and click Install Certificate

    Central_Support_18-1632211740320.png

     

    In the Certificate Import Wizard, Select Local Machine and click next.

    Central_Support_19-1632211789211.png

     

    Choose the Certificate store “Trusted Root Certification Authorities” and click next

    Central_Support_20-1632211828026.png

     

    Click Finish

    Central_Support_21-1632211868291.png

     

    To verify Https communication is working launch AMS.

    Go to Configuration -> Panels -> RPS API configuration

    Central_Support_22-1632211920457.png

     

    Verify all the values are correct and click Test the connection. A successful message will appear

    Central_Support_23-1632211960637.png
    Version history
    Revision #:
    1 of 1
    Last update:
    ‎09-21-2021 10:13 AM
    Updated by:
     
    Contributors
    Icon--AD-black-48x48Icon--address-consumer-data-black-48x48Icon--appointment-black-48x48Icon--back-left-black-48x48Icon--calendar-black-48x48Icon--center-alignedIcon--Checkbox-checkIcon--clock-black-48x48Icon--close-black-48x48Icon--compare-black-48x48Icon--confirmation-black-48x48Icon--dealer-details-black-48x48Icon--delete-black-48x48Icon--delivery-black-48x48Icon--down-black-48x48Icon--download-black-48x48Ic-OverlayAlertIcon--externallink-black-48x48Icon-Filledforward-right_adjustedIcon--grid-view-black-48x48IC_gd_Check-Circle170821_Icons_Community170823_Bosch_Icons170823_Bosch_Icons170821_Icons_CommunityIC-logout170821_Icons_Community170825_Bosch_Icons170821_Icons_CommunityIC-shopping-cart2170821_Icons_CommunityIC-upIC_UserIcon--imageIcon--info-i-black-48x48Icon--left-alignedIcon--Less-minimize-black-48x48Icon-FilledIcon--List-Check-grennIcon--List-Check-blackIcon--List-Cross-blackIcon--list-view-mobile-black-48x48Icon--list-view-black-48x48Icon--More-Maximize-black-48x48Icon--my-product-black-48x48Icon--newsletter-black-48x48Icon--payment-black-48x48Icon--print-black-48x48Icon--promotion-black-48x48Icon--registration-black-48x48Icon--Reset-black-48x48Icon--right-alignedshare-circle1Icon--share-black-48x48Icon--shopping-bag-black-48x48Icon-shopping-cartIcon--start-play-black-48x48Icon--store-locator-black-48x48Ic-OverlayAlertIcon--summary-black-48x48tumblrIcon-FilledvineIc-OverlayAlertwhishlist