You need to define certain properties for each SSL mode.
Important
When connecting to the Red Hat JBoss Data Virtualization server with SSL enabled, you must use the "mms" protocol, instead of "mm" in the JDBC connection URL:
jdbc:teiid:<myVdb>@mms://<host>:<port>
jdbc:teiid:<myVdb>@mms://<host>:<port>
Copy to ClipboardCopied!Toggle word wrapToggle overflow
There are two different sets of properties that a client can configure to enable 1-way or 2-way SSL.
The first option is to use Java SSL properties. These are standard Java defined system properties to configure the SSL under any JVM. Red Hat JBoss Data Virtualization is not unique in its use of SSL. Provide the following system properties to the client VM process.
Copy to ClipboardCopied!Toggle word wrapToggle overflow
The second option is to use JDV-specific properties. Use this option when the above "javax" based properties are already in use by the host process. For example if your client application is a Tomcat process that is configured for HTTPS protocol and the above Java-based properties are already in use, and importing Teiid-specific certificate keys into those HTTPS certificate keystores is not allowed.
In this scenario, a different set of JDV-specific SSL properties can be set as system properties or defined inside the teiid-client-settings.properties file. A sample teiid-client-settings.properties file can be found inside the teiid-client-[VERSION]-redhat-[VERSION].jar file at the root called teiid-client-settings.orig.properties. Extract this file, make a copy, change the property values required for the chosen SSL mode, and place this file in the client application's classpath before the teiid-client-[VERSION]-redhat-[VERSION].jar file.
Here are the SSL properties and definitions that can be set in a teiid-client-settings.properties file:
SSL Settings
The key store type. Defaults to JKS
The key store algorithm, defaults to
the system property "ssl.TrustManagerFactory.algorithm"
The classpath or filesystem location of the
key store.
This property is required only if performing 2-way
authentication that requires a specific private
key.
The key store password (not required)
The key alias(not required, if given named certificate is used)
The key password(not required, used if the key password is different than the keystore password)
The classpath or filesystem location of the
trust store.
This property is required if performing 1-way
authentication that requires trust not provided
by the system defaults.
The trust store password (not required)
The cipher protocol, defaults to TLSv3
Whether to allow anonymous SSL
(the TLS_DH_anon_WITH_AES_128_CBC_SHA cipher suite)
defaults to true
########################################
# SSL Settings
########################################
#
# The key store type. Defaults to JKS
#
org.teiid.ssl.keyStoreType=JKS
#
# The key store algorithm, defaults to
# the system property "ssl.TrustManagerFactory.algorithm"
#
#org.teiid.ssl.algorithm=
#
# The classpath or filesystem location of the
# key store.
#
# This property is required only if performing 2-way
# authentication that requires a specific private
# key.
#
#org.teiid.ssl.keyStore=
#
# The key store password (not required)
#
#org.teiid.ssl.keyStorePassword=
#
# The key alias(not required, if given named certificate is used)
#
#org.teiid.ssl.keyAlias=
#
# The key password(not required, used if the key password is different than the keystore password)
#
#org.teiid.ssl.keyPassword=
#
# The classpath or filesystem location of the
# trust store.
#
# This property is required if performing 1-way
# authentication that requires trust not provided
# by the system defaults.
#
#org.teiid.ssl.trustStore=
#
# The trust store password (not required)
#
#org.teiid.ssl.trustStorePassword=
#
# The cipher protocol, defaults to TLSv3
#
org.teiid.ssl.protocol=TLSv1
#
# Whether to allow anonymous SSL
# (the TLS_DH_anon_WITH_AES_128_CBC_SHA cipher suite)
# defaults to true
#
org.teiid.ssl.allowAnon=true
1-way SSL
org.teiid.ssl.trustStore=<dir>/server.truststore (required)
2-way SSL
org.teiid.ssl.keyStore=<dir>/client.keystore (required)
org.teiid.ssl.trustStore=<dir>/server.truststore (required)
Copy to ClipboardCopied!Toggle word wrapToggle overflow
Red Hat Summit
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}