Skip to main content

Configure SSL for BI Hub Web

This section explains the steps to configure the SSL if you have installed BI Hub Web with Nginx.

note

If you have installed BI Hub Web without Nginx, then configuring SSL will be out of the scope for this document.

By default, the bundled Nginx will contain the self-signed SSL certificate issued to example.com.

Kindly have the proper SSL certificate from the authorized vendor in .crt format and key file. You can also have your Self-Signed SSL certificate, but you need to make sure that the certificate belongs to a trusted certificate store by following the configuration steps provided by the particular browser which is out of scope for this document.

BI Hub recommends having the proper SSL certificate from the authorized vendor.

Follow the steps below to configure SSL:

  1. Rename the SSL files to the required names:

    • X.X.X.X.crt file should be renamed to server.crt, and X.X.X.X.key file should be renamed to server.key.

  2. Go to the nginx directory <installation_folder>/VBIViewWeb/nginx/nginx/conf and take backup of the server.crt and server.key files.

    If the SSL configuration fails, we will need these files to bring back the server to normal working condition.

  3. Replace these files with your trusted SSL files.

  4. Edit the config.json file located in the directory C:\Program Files\Visual BI Solutions\VBI View\VBIViewWeb, and change the value of host from http to https:

    C:\Program Files\Visual BI Solutions\VBI View\VBIViewWeb\config.json
    {
    "host": "https://...",
    "port": 12000
    }

  5. Restart the Nginx Server for the configuration to take effect.

  • Go to <installation_folder>/VBIViewWeb/nginx/ directory, and run the manager-windows.exe file as administrator.
  • Go to the Manage Server tab. Select Nginx and click Restart ( Wait for the server to get restarted and close the window).

Open the browser and enter <https://Backend server url> in the address bar.

BI Hub Web with secured SSL connection

BI Hub Web with secured SSL connection

✅ BI Hub Web will be loaded with a secured SSL connection.

Troubleshooting#

  • If there is any problem in restarting the server, check the log files for the errors which could be found in the following location: <installation_folder>/VBIViewWeb/nginx/nginx/logs/.
  • If the problem persists, replace the old SSL files with the new ones and restart the server.
  • If the server starts successfully, verify the SSL certificate and have a proper SSL format.
note

If you continue to have the problem, you could raise the support ticket in the support portal or by sending an email to support@bihub.com with supported log files and error images.

important

If you are going to configure SSL, please make sure that BI Hub Server and BI Hub Agents and their respective BI platforms should also be configured with proper SSL.

You cannot access HTTP content from the https protocol. The browser will throw a mixed content error if you try to access HTTP content from the https URL.