Contact us at |support@ssldragon.com
  • install an SSL certificate on Tableau Server

How to install an SSL Certificate on Tableau Server?

Monday, April 15th, 2019

In this article, you will learn how to generate a CSR code and install an SSL Certificate on Tableau Server. By the end of this configuration guide, you will also know a few interesting facts about Tableau Server’s history, as well as where to buy the best SSL certificate for Tableau.

If you’ve already generated the CSR code elsewhere, feel free to skip the CSR creation guidelines. Since Tableau Server works with both Windows and Linux, we’ve provided separate CSR generation operating system. Thanks to Tableau Server Manager (TSM) Web UI, the process of installing SSL certs on Windows and Linux systems is the same Use the anchor links below to jump straight to the relevant section.

Generate a CSR code on Tableau Server for Windows
Generate a CSR code on Tableau Server for Linux
Install an SSL Certificate on Tableau Server
Test your SSL installation
Tableau Server history and versions
Where to buy the best SSL certificate for a Tableau Server?

Generate a CSR code on Tableau Server for Windows

Tableau Server runs on Apache software, which includes the OpenSSL utility. You can use the OpenSSL toolkit to create a CSR (Certificate Signing Request) and a private key file. You will submit the CSR code to your CA when ordering the SSL certificate. As for the private key, you will install it on Tableau along with the signed SSL files.

To generate your CSR and private key files, please perform the following:

  1. Log in as administrator, and open the Command Prompt
  2. Access the Apache bin directory for Tableau Server. Here’s the default location:
    C:\Program Files\Tableau\Tableau Server\packages\apache. <version_code>\bin

    Note: In the version_code attribute, add the build number of your server. For example, 20183.18.1128.2033

  3. Run the command below to create the private key file:
    openssl.exe genrsa -out <yourcertname>.key 2048
  4. Next, use the key file you’ve just created, to generate your CSR code by running the following command:
    openssl.exe req -new -key yourcertname.key -out yourcertname.csr
  5. If you receive a warning that the usr/local/ssl directory cannot be found, ignore this message. Such a directory doesn’t exist on Windows.
  6. If you get an error message about the config information being unable to load, you need to set the Open SSL configuration variable, rerun the CSR generation command with the following parameter: – ..\conf\openssl.cnf
  7. The Open SSL utility will prompt you to submit the following information:
    • Country Name (2 letter code): type the two-letter code of your country. For example, US
    • State or Province Name: write the full name of the state where your business is registered. For instance, California
    • Locality Name: enter the full name of the city where your company is located. For example, San Francisco
    • Organization name: specify the full legal name of your company. For instance, Your Company LLC
    • Organizational Unit Name: this is the department within your company, requesting the SSL Certificate. For example, IT or Web Administration
    • Common Name: enter the URL that you’ll use to connect to the Tableau Server. For example, if you access Tableau via yoursite.com, then this is your common name.
    • Email Address: provide a valid email address
    • Extra Attributes: leave them blank
  8. That’s it! You’ve successfully generated your CSR code. You can open it with any text editor such as Notepad. During the SSL order process, you’ll need to send the CSR to your CA (Certificate Authority) to apply for the digital certificate.

Generate a CSR code on Tableau Server for Linux:

Tableau Server uses Apache software, which supports the OpenSSL utility. You can use the OpenSSL toolkit to create a CSR (Certificate Signing Request) and a private key file. You will submit the CSR code to your CA when ordering the SSL certificate. As for the private key, you will install it on Tableau along with the signed SSL files.

To generate your CSR and private key files, please follow the steps below:

  1. For the Tableau Server, change to the Apache bin directory:
    /opt/tableau/tableau_server/packages/apache.<version_code>/bin

    Note: In the version_code attribute, add the build number of your server. For example, 20183.18.1128.2033

  2. To create your private key file, run the following command:
    openssl genrsa -out <yourcertname>.key 2048
  3. To generate your CSR code, run the following command:
    openssl req -new -key yourcertname.key -out yourcertname.csr -config ../conf/openssl.cnf
  4. The Open SSL utility will prompt you to provide the following contact details:
    • Country Name (2 letter code): enter the two-letter code of your country. For example, CA
    • State or Province Name: specify the full name of the state where your organization is registered. For instance, Ontario
    • Locality Name: type the full name of the city where your company is located. For example, Ottawa
    • Organization name: write the full legal name of your company. For instance, Your Company LLC
    • Organizational Unit Name: this is the department within your company, requesting the SSL Certificate. For example, IT or Web Administration
    • Common Name: enter the URL that you’ll use to connect to the Tableau Server. For example, if you access Tableau via yoursite.com, then this is your common name.
    • Email Address: provide a valid email address
    • Extra Attributes: leave them blank
  5. Congrats, you’ve successfully generated your CSR code. You can open it with any text editor such as Notepad. During the SSL order process, you’ll need to send the CSR to your CA (Certificate Authority) to apply for the digital certificate.

Install an SSL Certificate on Tableau Server

After the CA signs your SSL Certificate and sends the necessary files to your inbox, download the ZIP folder and extract its contents on your device. Most of the CAs will send you the primary SSL certificate file, along with the CA Bundle or Chain certificate file, which contains the root and intermediate certificates.

The CA certificate files must be in PEM format with the extension .crt. In addition to the certificate files, you will also need the private key file with .key extension. Remember, you created the private key during the CSR generation with the OpenSSL utility.

To import your SSL files, please perform the following:

  1. Launch the Tableau Server Manager (TSM) in a browser: https://<tsm-computer-name>:8850
  2. Go to the Configuration Tab, and select Security > External SSL
  3. Under External web server SSL, tick the Enable SSL for server communication checkbox
  4. Upload the SSL certificate and key files as shown below:
    • SSL certificate file: upload your primary SSL certificate
    • SSL certificate key file: upload your private key file
    • SSL certificate key passphrase: leave blank
    • SSL certificate chain file: upload your CA bundle file with root and intermediate certificates
  5. Click Save Pending Changes, then navigate to the top of the page and click Pending Changes
  6. Hit Apply Changes and Restart.

Congratulations, you’ve successfully installed your SSL Certificate on Tableau Server.

Test your SSL installation

After you install the SSL Certificate on Tableau Server, you should run an SSL scan to look for potential errors or vulnerabilities in your configuration. For more info, check our article on the best SSL tools for testing an SSL Certificate.

Tableau Server history and versions

Tableau Software, Inc. is an American software company founded in 2003 by Christian Chabot and Chris Stolte. Tableau specializes in interactive data visualization products focused on business intelligence.

Tableau Server is an online hosting platform for privately sharing tableau works, data visualizations and more. Tableau Server allows organizations to understand, explore and manage their data more efficiently and securely.

Listed below, are the latest major Tableau Server releases:

  • 2019.1, released February 15, 2019
  • 2018.3, released October 29, 2018
  • 2018.2, released July 30, 2018
  • 2018.1, released April 24, 2018

Where to buy the best SSL certificate for Tableau Server?

SSL Dragon is the only SSL vendor you’ll ever need. We’ve built strong partnerships with the best Certificate Authorities in the industry to offer you incredibly low prices across the entire range of SSL products. All our certificates are compatible with Tableau Server. Below are the types of SSL certificates available at SSL Dragon:

You can find the best SSL Certificate for your project and budget with the help of our exclusive SSL tools. The SSL Wizard offers a quick and efficient way to determine the right SSL for you, while the Advanced Certificate Filter allows you to sort and compare different certificates by price, validation, and features.

If you find any inaccuracies, or you have details to add to these SSL installation instructions, please feel free to send us your feedback at [email protected]. Your input would be greatly appreciated! Thank you.