Using SSL connections in DataStax Studio

Steps to connect Studio to an SSL-enabled DataStax Enterprise cluster.

Prerequisites

SSL must be configured and working on your DSE cluster. See Configuring SSL for details on:
  • Client-to-node encryption
  • Node-to-node encryption
  • Preparing server certificates
DataStax recommends using certificates signed by a CA. The truststore or CA certificate can be shared between all DSE servers and clients. See Creating local SSL certificate and keystore files.
For DataStax Studio, the public key certificate from the CA must be stored in a local truststore file. If two-way SSL is not configured, then only a truststore file is required. If two-way SSL is configured, an appropriate keystore file is also required.
Important: DataStax Studio only works with Java 8 .jks keystores and truststores.
To perform server verification, the client needs to have the public key certificate of each node in the cluster stored in a local truststore file. This truststore file is password protected.

Procedure

  1. In the menu (☰), select Connections.
  2. Click + to add a connection or click any of the listed connections to edit an existing connection.
  3. In the Create Connection dialog, enter the connection information:
    Name
    Name of the connection from the notebook to a DSE cluster.
    Host/IP (comma delimited)
    The host names or IP addresses of the DSE cluster to connect to. All hosts must be in a single datacenter. Default: localhost.
    Username
    Optional. DSE username for logging in.
    Password
    Optional. DSE password for logging in.
    Port
    IP connection port. Default: 9042.

    For example, to connect to a single-node DSE cluster on the local host using the default port.

    Name
    My First Connection
    Host/IP
    127.0.0.1
    Port
    9042
  4. Select the Use SSL check box to show the Truststore and Keystore fields.
  5. As appropriate for your environment, enter the local file path and password for the truststore and optionally the keystore.
  6. Click Test to verify the connection to the DSE cluster.