--- schema_version: "1" id: a76ae78dd365e3818fead6be559f61c3a07841fbbbf779c84f00ad793c7260bf title: "Example: SSL Certificate - Generate a Key and CSR" collection: tableau version: current locale: en-gb portal_url: https://docs.salesforce.com/tableau/current/en-gb/server-linux/ssl_cert_create.md canonical_url: https://help.tableau.com/current/server-linux/en-gb/ssl_cert_create.htm source_site: help.tableau.com content_type: documentation content_hash: 3d7a6d5c760a530cc4a01290dc19e93ffbd9d434467640084c975254768a76d0 description: Generate an SSL key and certificate signing request for Tableau Server. --- [Skip to main content](#main-content) # Example: SSL Certificate - Generate a Key and CSR Important: This example is intended to provide general guidance to IT professionals who are experienced with SSL requirements and configuration. The procedure described in this article is just one of many available methods you can use to generate the required files. The process described here should be treated as an example and not as a recommendation. * * * When you configure Tableau Server to use Secure Sockets Layer (SSL) encryption, this helps ensure that access to the server is secure and that data sent between Tableau Server and Tableau Desktop is protected. Looking for Tableau Server on Windows? See [Example: SSL Certificate - Generate a Key and CSR](https://help.tableau.com/current/server/en-gb/ssl_cert_create.htm "Opens topic in a new browser tab"). Tableau Server uses Apache, which includes [OpenSSL](http://www.openssl.org/). You can use the OpenSSL toolkit to generate a key file and Certificate Signing Request (CSR) which can then be used to obtain a signed SSL certificate. Tableau Server versions 2022.1.17, 2022.3.9, 2023.1.5, through to 2025.1.x run OpenSSL 3.1. **Important:** Beginning with version 2025.2 (Tableau Desktop), 2025.3 (Tableau Server) and June 2025 (Tableau Cloud), Tableau uses OpenSSL 3.4.x and Level-2 security. Level-2 security requires keys of 2,048 bits or longer. Any existing Level-1 security keys will no longer work, and you will need to generate and deploy a new key pair. If you have been generating at least 2,048-bit length keys as recommended, no action is necessary. For more information see [Generate a key](#generate-key). ## Steps to generate a key and CSR To configure Tableau Server to use SSL, you must have an SSL certificate. To obtain the SSL certificate, complete the steps: 1. [Generate a key file](#generate-key). 2. [Create a Certificate Signing Request (CSR)](#generate-csr). 3. [Send the CSR to a certificate authority (CA) to obtain an SSL certificate](#send-csr). 4. [Use the key and certificate to configure Tableau Server to use SSL](#config-server). You can find additional information on the [SSL FAQ page](http://httpd.apache.org/docs/2.2/ssl/ssl_faq.html#realcert) on the Apache Software Foundation website. ### Configure a certificate for multiple domain names Tableau Server allows SSL for multiple domains. To set up this environment, you need to modify the OpenSSL configuration file, openssl.conf, and configure a Subject Alternative Name (SAN) certificate on Tableau Server. See [For SAN certificates: modify the OpenSSL configuration file](#san-certs) below. ### Generate a key Generate a key file that you will use to generate a certificate signing request. 1. Run the following command to create the key file: `openssl genrsa -out .key 4096` **Notes:** - This command uses a 4096-bit length for the key. You should choose a bit length that is at least 2048 bits because communication encrypted with a shorter bit length is less secure. If a value is not provided, 512 bits is used. - To create PKCS#1 RSA keys with Tableau Server versions 2021.3.26, 2021.4.21, 2022.1.17, 2022.3.9, 2023.1.5 and later, you must use the additional option `-traditional` when running `openssl genrsa`" command based on the OpenSSL 3.1. For more information about the option, see [https://www.openssl.org/docs/man3.1/man1/openssl-rsa.html](https://www.openssl.org/docs/man3.1/man1/openssl-rsa.html). ### Create a certificate signing request to send to a certificate authority Use the key file you created in the procedure above to generate the certificate signing request (CSR). You send the CSR to a certificate authority (CA) to obtain a signed certificate. **Important:** If you want to configure a SAN certificate to use SSL for multiple domains, first complete the steps in [For SAN certificates: modify the OpenSSL configuration file](#san-certs) below, and then return to here to generate a CSR. 1. Run the following command to create a certificate signing request (CSR) file: openssl req -new -key yourcertname.key -out yourcertname.csr -config /opt/tableau/tableau\_server/packages/apache./conf/openssl.cnf 2. When prompted, enter the required information. **Note:** For **Common Name**, type the Tableau Server name. The Tableau Server name is the URL that will be used to reach the Tableau Server. For example, if you reach Tableau Server by typing `tableau.example.com` in the address bar of your browser, then `tableau.example.com` is the common name. If the common name does not resolve to the server name, errors will occur when a browser or Tableau Desktop tries to connect to Tableau Server. ### Send the CSR to a certificate authority to obtain an SSL certificate Send the CSR to a commercial certificate authority (CA) to request the digital certificate. For information, see the Wikipedia article [Certificate authority](http://en.wikipedia.org/wiki/Certificate_authority) and any related articles that help you decide which CA to use. ### Use the key and certificate to configure Tableau Server When you have both the key and the certificate from the CA, you can configure Tableau Server to use SSL. For the steps, see [Configure External SSL](https://help.tableau.com/current/server-linux/en-gb/ssl_config.htm). ## For SAN certificates: modify the OpenSSL configuration file In a standard installation of OpenSSL, some features are not enabled by default. To use SSL with multiple domain names, before you generate the CSR, complete these steps to modify the **openssl.cnf** file. 1. Navigate to the Apache **conf** folder for Tableau Server. For example: `/opt/tableau/tableau_server/packages/apache./conf` 2. Open **openssl.cnf** in a text editor, and find the following line: `req_extensions = v3_req` This line might be commented out with a hash sign (#) at the beginning of the line. ![The code demonstrates how to set extensions to be added to a certificate request.](/tableau/current/en-gb/server-linux/en-gb/Img/creating-ssl-cert-and-key1.png) If the line is commented out, uncomment it by removing the **#** and **space** characters from the beginning of the line. 3. Move to the **\[ v3\_req \]** section of the file. The first few lines contain the following text: `# Extensions to add to a certificate request basicConstraints = CA:FALSE keyUsage = nonRepudiation, digitalSignature, keyEncipherment` After the **keyUsage** line, insert the following line: `subjectAltName = @alt_names` If you’re creating a self-signed SAN certificate, do the following to give the certificate permission to sign the certificate: 1. Add the `cRLSign` and `keyCertSign` to the **keyUsage** line so it looks like the following: `keyUsage = nonRepudiation, digitalSignature, keyEncipherment, cRLSign, keyCertSign` 2. After the **keyUsage** line, add the following line: `subjectAltName = @alt_names` 4. In the **\[alt\_names\]** section, provide the domain names you want to use with SSL. `DNS.1 = [domain1] DNS.2 = [domain2] DNS.3 = [etc]` The following image shows the results highlighted, with placeholder text that you would replace with your domain names. ![](/tableau/current/en-gb/server-linux/en-gb/Img/creating-ssl-cert-and-key2.png) 5. Save and close the file. 6. Complete the steps in [Create a certificate signing request to send to a certificate authority](#generate-csr) section, above.