Trust internal certificates#
Configure the Starburst control plane to trust self-signed certificates or certificates signed by an internal certificate authority (CA) using one of the following methods:
System truststore: Add certificates to the Java system trust store.
JVM options: Configure a custom truststore in
jvm.config.Application configuration: Configure truststores for the two control plane components that support it.
Note
Control plane supports configuring only one truststore. Include certificates for all clusters in this truststore.
System truststore#
Add your cluster certificates or your CA certificate to the Java system truststore:
keytool -importcert -alias cluster-ca \
-file /path/to/ca-certificate.pem \
-keystore $JAVA_HOME/lib/security/cacerts \
-storepass <TRUSTSTORE_PASSWORD>
JVM options#
Configure a custom truststore in jvm.config:
-Djavax.net.ssl.trustStore=/path/to/truststore.jks
-Djavax.net.ssl.trustStorePassword=<TRUSTSTORE_PASSWORD>
Application configuration#
Control plane supports application-level truststore properties for only the following two components. Other HTTP clients in control plane can’t be configured this way, so use the system truststore or JVM options for them.
To configure the proxy HTTP client for proxying requests to backend clusters,
set the following properties in your config.properties file:
proxy.http-client.trust-store-path=/path/to/truststore.jks
proxy.http-client.trust-store-password=<TRUSTSTORE_PASSWORD>
To configure internal communication with clusters for health checks and
monitoring, set the following properties in your config.properties file:
clusters.internal-communication.https.truststore.path=/path/to/truststore.jks
clusters.internal-communication.https.truststore.key=<TRUSTSTORE_PASSWORD>