DataGrip 2021.2 Help

Apache Cassandra with SSL

Step 1. Create a Apache Cassandra connection

  1. Open data source properties. You can open data source properties by using one of the following options:

    • Navigate to File | Data Sources.

    • Press Ctrl+Alt+Shift+S.

    • In the Database tool window (View | Tool Windows | Database), click the Data Source Properties icon The Data Source Properties icon.

  2. In the Data Sources and Drivers dialog, click the Add icon (The Add icon) and select Apache Cassandra.

  3. At the bottom of the data source settings area, click the Download missing driver files link. As you click this link, DataGrip downloads drivers that are required to interact with a database. To decrease the size of the installation package and keep driver versions up-to-date, drivers are not bundled with the IDE.

    You can specify your own drivers for the data source if you do not want to download the provided drivers. For more information about creating a database connection with your driver, see Add a user driver to an existing connection.

  4. In Host, Keyspace, User, Password, and Port fields, specify connection details.

Step 2. Verify the version of the JDBC driver

Verify that you use the JDBC driver of version 1.3, or later.

  1. Open data source properties. You can open data source properties by using one of the following options:

    • Navigate to File | Data Sources.

    • Press Ctrl+Alt+Shift+S.

    • In the Database tool window (View | Tool Windows | Database), click the Data Source Properties icon The Data Source Properties icon.

  2. In the Drivers list, select Apache Cassandra.

  3. In the Driver files pane, click ver. <version_number> and select Latest or 1.3.

Verify the version of the JDBC driver

Step 3. Set VM options

  1. Open data source properties. You can open data source properties by using one of the following options:

    • Navigate to File | Data Sources.

    • Press Ctrl+Alt+Shift+S.

    • In the Database tool window (View | Tool Windows | Database), click the Data Source Properties icon The Data Source Properties icon.

  2. In the Drivers list, select Apache Cassandra.

  3. In the driver settings, click the Advanced tab.

  4. In the VM options field, specify options for authentication.

    • Server authentication: your client verifies that the server is correct and trusted. The truststore must contain a public key of the server or the CA certificate that was used to sign the server key.

      -Djavax.net.ssl.trustStore=<path_to_client_truststore> -Djavax.net.ssl.trustStorePassword=<truststore_password>
    • Client authentication: the server verifies the client that tries to connect to the server.

      -Djavax.net.ssl.keyStore=<path_to_client_keystore> -Djavax.net.ssl.keyStorePassword=<keystore_password>
Set VM options

Step 4. Add the sslenabled option to the JDBC URL

  1. Add the sslenabled=true option to the JDBC URL. For example, jdbc:cassandra://localhost:9042/?sslenabled=true.

  2. To ensure that the connection to the data source is successful, click Test Connection.

Add the sslenabled option to the JDBC URL
Last modified: 08 March 2021