Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
Showing results for 
Search instead for 
Did you mean: 
Product and Topic Expert
Product and Topic Expert

LATEST UPDATE: September 1, 2020 =========================================

The SAP Cloud Platform, SAP HANA Service will be retired in 2021. For more information, see

For the latest information about SAP HANA database-as-a-service, visit our blog post series about SAP HANA Cloud:


The SAP HANA Service on the SAP Cloud Platform only accepts secure (encrypted) connections from client tools. To make this happen, you have two options:

  1. Use the default (built-in) TLS/SSL security provider of your platform

  2. Use the SAP CommonCrypto Library (SCL)

This blog is about the first option. It is the easiest to use and requires almost no configuration on the Microsoft Windows or Java platforms and minimal setup on macOS and Linux.

For the blog about the CommonCryptoLib, see

Cloud Foundry, Neo, and On-Premise

In the tutorial video we are using the SAP HANA Service from the Cloud Foundry environment. However, as this concerns client-side configuration, it works exactly the same in the Neo environment (SAP datacenter).

For those interested in how to configure secure SAP HANA client connections for on-premise SAP HANA, just ignore the "Service" word. Again, on the client-side it works the same.

For more information about client connections to the SAP HANA Service, see


Using the built-in security providers does have some restrictions as they cannot be used for SAP HANA Client Side Encryption, for example. CSE requires SCL.

The SAP CommonCrypto Library was created by SAP to guarantee a secure compute environment regardless of the underlying platform. For on-premise SAP HANA, openSSL has been deprecated.

For the blog about CSE, see

Code Sample

For the full code samples, see the repository on the SAP HANA Academy GitHub site

Tutorial Video

In the video tutorial below, we show how to configure secure client connections on Microsoft Windows, macOS and SUSE Linux for ODBC and JDBC, for the SAP HANA interactive terminal hdbsql, for Java in Eclipse, and for Python in a Jupyter Notebook.

Hands-On Video

For those already familiar with the topic, here is a short(er) video with focus on just the Microsoft Windows platform.

Working with Built-In TLS/SSL Providers

When you are running Microsoft Windows or connecting to HaaS from a Java VM, the default provider is automatically called when you set encrypt=true (either as parameter or in a GUI). The built-in providers include a certificate authority (CA) root certificate.

When you using the open source openSSL encryption provider on macOS or Linux, you do need to explicitly define this plus you need to point to the CA root certificate for openSSL to use to validate the certificate received from the SAP HANA Service.

Connecting to the SAP HANA Service using JDBC in Eclipse


Connecting to the SAP HANA Service using Python in a Jupyter Notebook


Connecting to the SAP HANA Service using ODBC on macOS


YouTube Playlist(s)

The tutorials has been posted to the following playlists:


For the full code samples, see

For the documentation, see

Thank you for watching

The SAP HANA Academy provides free online video tutorials for the developers, consultants, partners and customers of SAP HANA.

Topics range from practical how-to instructions on administration, data loading and modeling, and integration with other SAP solutions, to more conceptual projects to help build out new solutions using mobile applications or predictive analysis.

For the full library, see SAP HANA Academy Library - by the SAP HANA Academy.

For the full list of blogs, see Blog Posts - by the SAP HANA Academy.