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. From your terminal, SSH to your Zoomdata Server.
  2. Stop the Zoomdata Server service:
    sudo service zoomdata stop
  3. Copy your SSL keystore file to the /etc/zoomdata or /opt/zoomdata/conf directory.
    To obtain the SSL keystore file, work with your website domain provider.
  4. 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.
  5. 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.
  6. Save and exit the .properties file.
  7. 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.