Zoomdata Version

Adding an SSL Certificate to the Zoomdata Server

Zoomdata supports SSL Certificates so that a secure connection between the Zoomdata Server and the browser can be established. In particular, Zoomdata supports two common formats for SSL Certificates - JKS and PKCS12.

To enable HTTPS and a secure browser connection, the SSL Certificate needs to be copied into the appropriate Zoomdata directory and the proper parameters be added to the zoomdata.properties configuration file.

Perform the following steps:

  1. Log out of Zoomdata if you are in the program; then close the browser.
  2. From your terminal, open a command line session.
  3. Via the command prompt, connect to your Zoomdata Server.
  4. Stop the Zoomdata Server service:
sudo service zoomdata stop
  1. Copy your SSL keystore file to the /etc/zoomdata directory.
To obtain the SSL keystore file, work with your website domain provider.
  1. Use the following command to access and open the zoomdata.properties file:
vi /etc/zoomdata/zoomdata.properties
If the .properties file does not exist, this command will create the file.
  1. Add the following lines to the file:
server.port=8443
server.ssl.enabled=true
server.ssl.key-store=/etc/zoomdata/ keystore_name
server.ssl.key-store-password= your_keystore_password
Replace the placeholders keystore_name and your_keystore_password with your keystore details. Zoomdata supports the 'JKS' and 'PKCS12' certificate formats.
  1. If you want to authenticate your users in Zoomdata using x.509 certificate, add the following lines to the zoomdata.properties file:
server.ssl.client-auth=want
  1. Save and exit the .properties file.
  2. Start Zoomdata:
sudo service zoomdata start

Once the Zoomdata Server has successfully restarted, open a new browser and check for a secure connection (that is, HTTPS).

REVERTING THE SSL CERTIFICATE TO THE DEFAULT ZOOMDATA VERSION

If you need to remove the SSL Certificate later on, you will need to edit the zoomdata.properties file so that the SSL Certificate is reverted back to the default Zoomdata version. Edit the zoomdata.properties file as follows:

server.ssl.key-store=/opt/zoomdata/conf/keystore
keystorePass=changeit

Remember to save and exit the .properties file. Then restart the Zoomdata Server:

sudo service zoomdata restart

This action will revert the SSL connection to the original self-signed certificate that comes pre-installed with the Zoomdata Server.