Skip to content

Commit

Permalink
Add TLS documentation for hana
Browse files Browse the repository at this point in the history
Co-authored-by: Steve Burnett <burnett@pobox.com>
  • Loading branch information
2 people authored and tdcmeehan committed Feb 28, 2024
1 parent d4e9213 commit eeda9c4
Showing 1 changed file with 35 additions and 1 deletion.
36 changes: 35 additions & 1 deletion presto-docs/src/main/sphinx/connector/hana.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,40 @@ connection properties as appropriate for your setup:
connection-user=root
connection-password=secret
Connection security
-------------------

The JDBC driver and connector automatically use Transport Layer Security (TLS) encryption and certificate validation. This requires a suitable TLS certificate configured on your Hana database host.

To enable encryption in the connection string, use the ``encrypt`` property:

.. code-block:: none
connection-url=jdbc:sap://<host>:<port>?encrypt=true;
Other SSL configuration properties that can be configured using the ``connection-url``:

SSL Configuration Properties
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
================================================== ==================================================================== ===========
Property Name Description Default
================================================== ==================================================================== ===========
``validateCertificate`` Indicates that the SSL certificate presented by the server ``true``
should be validated against the truststore specified.

``trustStoreType`` File format of the truststore file, for example ``JKS``.

``trustStore`` The path to the truststore file.

``trustStorePassword`` The password for the truststore.
================================================== ==================================================================== ===========

A connection string using a truststore would be similar to the following example:

.. code-block:: none

connection-url=jdbc:sap://<host>:<port>?encrypt=true&validateCertificate=true&trustStore=path/to/truststore.jks&trustStorePassword=password&trustStoreType=jks

Multiple HANA Databases or Servers
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Expand Down Expand Up @@ -97,4 +131,4 @@ The following SQL statements are not supported:
* :doc:`/sql/revoke`
* :doc:`/sql/show-grants`
* :doc:`/sql/show-roles`
* :doc:`/sql/show-role-grants`
* :doc:`/sql/show-role-grants`

0 comments on commit eeda9c4

Please sign in to comment.