Zoomdata Version

Adding an SSL Certificate

Zoomdata supports SSL crtificates 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. For information on creating a keystore or Certificate Signing Request (CSR) for use with Zoomdata, see https://www.digicert.com/code-signing/java-code-signing-guide.htm.

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 Zoomdata services. See Stopping Zoomdata Services.
  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 zoomdata.properties 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 services. See Starting Zoomdata Services. .

After 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, you must 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 Zoomdata services. See Restarting Zoomdata Services.

This reverts the SSL connection to the original self-signed certificate preinstalled with Zoomdata.

Was this topic helpful?