druid/docs/content/development/extensions-core/simple-client-sslcontext.md

3.7 KiB

layout title
doc_page Simple SSLContext Provider Module

Simple SSLContext Provider Module

This module contains a simple implementation of SSLContext that will be injected to be used with HttpClient that Druid processes use internally to communicate with each other. To learn more about Java's SSL support, please refer to this guide.

Configuration

Property Description Default Required
druid.client.https.protocol SSL protocol to use. TLSv1.2 no
druid.client.https.trustStoreType The type of the key store where trusted root certificates are stored. java.security.KeyStore.getDefaultType() no
druid.client.https.trustStorePath The file path or URL of the TLS/SSL Key store where trusted root certificates are stored. none yes
druid.client.https.trustStoreAlgorithm Algorithm to be used by TrustManager to validate certificate chains javax.net.ssl.TrustManagerFactory.getDefaultAlgorithm() no
druid.client.https.trustStorePassword The Password Provider or String password for the Trust Store. none yes

The following table contains optional parameters for supporting client certificate authentication:

Property Description Default Required
druid.client.https.keyStorePath The file path or URL of the TLS/SSL Key store containing the client certificate that Druid will use when communicating with other Druid services. If this is null, the other properties in this table are ignored. none yes
druid.client.https.keyStoreType The type of the key store. none yes
druid.client.https.certAlias Alias of TLS client certificate in the keystore. none yes
druid.client.https.keyStorePassword The Password Provider or String password for the Key Store. none no
druid.client.https.keyManagerFactoryAlgorithm Algorithm to use for creating KeyManager, more details here. javax.net.ssl.KeyManagerFactory.getDefaultAlgorithm() no
druid.client.https.keyManagerPassword The Password Provider or String password for the Key Manager. none no
druid.client.https.validateHostnames Validate the hostname of the server. This should not be disabled unless you are using custom TLS certificate checks and know that standard hostname validation is not needed. true no

This document lists all the possible values for the above mentioned configs among others provided by Java implementation.