Configuring TotalFlow BatchBuilder Notify Addon to use HTTPS protocol

Ricoh TotalFlow BatchBuilder provides support for using the HTTPS security protocol. The HTTPS protocol facilitates secure network communication by establishing an encrypted link between the server and the web browser user interface and ensures the privacy and integrity of all transmitted data. To allow communication with a TotalFlow BatchBuilder system that uses the HTTPS security protocol, you must configure TotalFlow BatchBuilder Notify Addon to use the HTTPS security protocol.

This is the procedure for enabling HTTPS on Windows 10. There might be minor differences in other versions of Windows.

If you changed the default installation path, make sure that you replace C:\Program Files\RICOH\TotalFlow BatchBuilder - NotifyAddon\ with the path where TotalFlow BatchBuilder Notify Addon is installed everywhere in the procedure.

To enable HTTPS, you need to import the digital certificate created for the TotalFlow BatchBuilder subscriber.

  1. Obtain the digital certificate and store it in C:\Program Files\RICOH\TotalFlow BatchBuilder - NotifyAddon\jre\bin on the computer where TotalFlow BatchBuilder Notify Addon is installed.
  2. On the computer where Ricoh TotalFlow BatchBuilder Notify Addon is installed, open a Command Prompt window as an administrator. Go to the folder that contains the Java keytool, using this command:
    cd "C:\Program Files\RICOH\TotalFlow BatchBuilder - NotifyAddon\jre\bin"
  3. To import the generated keystore file into Java security certificate run this command:
    keytool -import -alias selfsigned -keystore "C:\Program Files\RICOH\TotalFlow BatchBuilder - NotifyAddon\jre\lib\security\cacerts" -storepass "changeit" -file "C:\Program Files\RICOH\TotalFlow BatchBuilder - NotifyAddon\jre\bin\selfsigned.crt"

    where selfsigned.crt is the name of the certificate file.

  4. Configure the config.ini file
    1. Modify the C:\Program Files\RICOH\TotalFlow BatchBuilder - NotifyAddon\config.ini file as follows:
      In the url field under Subscriber section inside config.ini
      1. In the web address line, replace value http with https
      2. In the web address line, replace value 19080 with 19443
  5. Restart the TotalFlow BatchBuilder Notify Addon service.

Make sure that you repeat the procedure for enabling HTTPS whenever the certificate is about to expire. You must also repeat this procedure each time you run the installation process to reinstall, upgrade, or repair TotalFlow BatchBuilder Notify Addon.

    Note:
  • When users access the system, they are redirected to the secure protocol without having to take any action themselves. However, if you use a self-signed certificate or if the certificate is not specifically tied to the server, the web browser issues a warning that the certificate is not trusted.