MySQL JDBC连接串中sslMode含义、与useSSL、requireSSL的关系

本文主要是介绍MySQL JDBC连接串中sslMode含义、与useSSL、requireSSL的关系，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

引言

从Java连接MySQL的连接属性中获取sslMode的含义

版本

驱动版本

<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>8.0.29</version>
</dependency>

服务端版本

Database Version: 8.0.35

SSL参数含义与默认值

序号	值	默认值	含义
1	sslMode	PREFERRED	默认情况下，网络连接是SSL加密的；此属性允许关闭安全连接，或者选择不同的安全级别。
2	useSSL	true	与服务器通信时使用SSL（true/false）
3	requireSSL	false	如果useSSL=true，则要求服务器支持SSL连接
4	verifyServerCertificate	false
/	/	/	/
1	trustCertificateKeyStoreType	JKS	受信任的根证书的密钥存储类型。
2	trustCertificateKeyStoreUrl	/	受信任的根证书密钥存储的URL。 [CR]如果未指定，属性“fallbackToSystemTrustStore”将确定是否使用系统范围的信任存储。
3	trustCertificateKeyStorePassword	/	受信任的根证书密钥存储的密码。
4	fallbackToSystemKeyStore	true	没有为“clientCertificateKeyStoreUrl”设置值是否会返回到使用通过系统属性“javax.net.ssl.keyStore*”定义的系统范围的密钥存储。
/	/	/	/
1	clientCertificateKeyStoreType	JKS	客户端证书的密钥存储类型。JVM支持的标准密钥存储类型是“JKS\”和“PKCS12\”
2	clientCertificateKeyStoreUrl	/	客户端证书KeyStore的URL。 如果未指定，属性“fallbackToSystemKeyStore”将确定是否使用系统范围的密钥存储。
3	clientCertificateKeyStorePassword	/	客户端证书密钥存储的密码。
4	fallbackToSystemKeyStore	true	没有为“clientCertificateKeyStoreUrl”设置值是否会返回到使用通过系统属性“javax.net.ssl.keyStore*”定义的系统范围的密钥存储。"

详细含义-中英文对比

sslMode

By default, network connections are SSL encrypted; this property permits secure connections to be turned off, or a different levels of security to be chosen. 
The following values are allowed: 
\"DISABLED\" - Establish unencrypted connections; 
\"PREFERRED\" - (default) Establish encrypted connections if the server enabled them, otherwise fall back to unencrypted connections; 
\"REQUIRED\" - Establish secure connections if the server enabled them, fail otherwise; 
\"VERIFY_CA\" - Like \"REQUIRED\" but additionally verify the server TLS certificate against the configured Certificate Authority (CA) certificates;
\"VERIFY_IDENTITY\" - Like \"VERIFY_CA\", but additionally verify that the server certificate matches the host to which the connection is attempted.
[CR] This property replaced the deprecated legacy properties \"useSSL\", \"requireSSL\", and \"verifyServerCertificate\", 
which are still accepted but translated into a value for \"sslMode\" if \"sslMode\" is not explicitly set: 
\"useSSL=false\" is translated to \"sslMode=DISABLED\"; 
{\"useSSL=true\", \"requireSSL=false\", \"verifyServerCertificate=false\"} is translated to \"sslMode=PREFERRED\"; 
{\"useSSL=true\", \"requireSSL=true\", \"verifyServerCertificate=false\"} is translated to \"sslMode=REQUIRED\"; 
{\"useSSL=true\" AND \"verifyServerCertificate=true\"} is translated to \"sslMode=VERIFY_CA\". 
There is no equivalent legacy settings for \"sslMode=VERIFY_IDENTITY\". 
Note that, for ALL server versions, the default setting of \"sslMode\" is \"PREFERRED\", and it is equivalent to the legacy settings of \"useSSL=true\", \"requireSSL=false\", and \"verifyServerCertificate=false\", 
which are different from their default settings for Connector/J 8.0.12 and earlier in some situations. Applications that continue to use the legacy properties and rely on their old default settings should be reviewed.
[CR] The legacy properties are ignored if \"sslMode\" is set explicitly. If none of \"sslMode\" or \"useSSL\" is set explicitly, the default setting of \"sslMode=PREFERRED\" applies. "

默认情况下，网络连接是SSL加密的；此属性允许关闭安全连接，或者选择不同的安全级别。
允许使用以下值：
\“DISABLED\”-建立未加密的连接；
\"PREFERRED\" - （默认）如果服务器启用了加密连接，则建立加密连接，否则返回到未加密连接；
\“REQUIRED\”-如果服务器启用了安全连接，则建立安全连接，否则将失败；
\“VERIFY_CA\”-类似于“REQUIRED\”，但还要根据配置的证书颁发机构（CA）证书验证服务器TLS证书；
\“VERIFY_IDENTITY\”-类似于“VERIFY_CA\”，但还要验证服务器证书是否与尝试连接的主机匹配。
[CR]此属性替换了不推荐使用的旧属性\“useSSL\”、\“requireSSL\”和\“verifyServerCertificate\”，
它们仍然被接受，但如果没有明确设置\“sslMode\”，则转换为\“sslMode”的值：
\“useSSL=false\”被翻译为“sslMode=DISABLED\”；
｛\“useSSL=true\”、“requireSSL=false\”、“verifyServerCertificate=false”｝被翻译为“sslMode=PREFERRED\”；
｛\“useSSL=true\”、\“requireSSL=true=”、“verifyServerCertificate=false\”｝被翻译为\“sslMode=REQUIRED\”；
｛\“useSSL=true\”AND\“verifyServerCertificate=true\”｝被翻译为\“sslMode=VERIFY_CA\”。
“sslMode=VERIFY_IDENTITY\”没有等效的旧设置。
请注意，对于所有服务器版本，“sslMode”的默认设置为“PREFERRED”，它等效于“useSSL=true\”、“requireSSL=false”和“verifyServerCertificate=false”的旧设置，
在某些情况下，这与连接器/J 8.0.12及更早版本的默认设置不同。应审查继续使用旧属性并依赖其旧默认设置的应用程序。
[CR]如果显式设置了\“sslMode\”，则会忽略旧属性。如果没有显式设置“sslMode\”或“useSSL\”，则应用默认设置“sslMode=PREFERRED\”。"

useSSL

For 8.0.12 and earlier: Use SSL when communicating with the server (true/false), 
default is 'true' when connecting to MySQL 5.5.45+, 5.6.26+ or 5.7.6+, otherwise default is 'false'.
[CR] For 8.0.13 and later: Default is 'true'. DEPRECATED. See sslMode property description for details."

对于8.0.12及更早版本：与服务器通信时使用SSL（true/false），
连接到MySQL 5.5.45+、5.6.26+或5.7.6+时默认为“true”，否则默认为“false”。
[CR]对于8.0.13及更高版本：默认值为“true”。已弃用。有关详细信息，请参阅sslMode属性描述。"

requireSSL

For 8.0.12 and earlier: Require server support of SSL connection if useSSL=true? (defaults to 'false').
[CR] For 8.0.13 and later: DEPRECATED. See sslMode property description for details.",

对于8.0.12及更早版本：如果useSSL=true，则要求服务器支持SSL连接？（默认为“false”）。
[CR]对于8.0.13及更高版本：已弃用。有关详细信息，请参阅sslMode属性描述。",

verifyServerCertificate

For 8.0.12 and earlier: If \"useSSL\" is set to \"true\", should the driver verify the server's certificate? 
When using this feature, the key store parameters should be specified by the \"clientCertificateKeyStore*\" properties, rather than system properties. 
Default is 'false' when connecting to MySQL 5.5.45+, 5.6.26+ or 5.7.6+ and \"useSSL\" was not explicitly set to \"true\". Otherwise default is 'true'.
[CR] For 8.0.13 and later: Default is 'false'. DEPRECATED. See sslMode property description for details."

对于8.0.12及更早版本：如果“useSSL\”设置为“true\”，驱动程序是否应该验证服务器的证书？
使用此功能时，密钥存储参数应由“clientCertificateKeyStore*”属性指定，而不是由系统属性指定。
当连接到MySQL 5.5.45+、5.6.26+或5.7.6+时，默认值为“false”，并且“useSSL\”未明确设置为“true\”。否则，默认值为“true”。
[CR]对于8.0.13及更高版本：默认值为“false”。已弃用。有关详细信息，请参阅sslMode属性描述。"

trustCertificateKeyStoreType

Key store type for trusted root certificates.
[CR]NULL or empty means use the default, which is \"JKS\". 
Standard key store types supported by the JVM are \"JKS\" and \"PKCS12\", your environment may have more available depending on what security products are installed and available to the JVM.

受信任的根证书的密钥存储类型。
[CR]NULL或空表示使用默认值，即“JKS\”。
JVM支持的标准密钥存储类型是“JKS\”和“PKCS12\”，您的环境可能有更多可用的密钥存储类型，这取决于JVM安装的安全产品和可用的安全产品。

trustCertificateKeyStoreUrl

URL for the trusted root certificates key store.
[CR]If not specified, the property 'fallbackToSystemTrustStore' determines if system-wide trust store is used.

受信任的根证书密钥存储的URL。
[CR]如果未指定，属性“fallbackToSystemTrustStore”将确定是否使用系统范围的信任存储。

trustCertificateKeyStorePassword

Password for the trusted root certificates key store.

受信任的根证书密钥存储的密码。

fallbackToSystemKeyStore

Whether the absence of setting a value for 'clientCertificateKeyStoreUrl' falls back to using the system-wide key store defined through the system properties 'javax.net.ssl.keyStore*'.

没有为“clientCertificateKeyStoreUrl”设置值是否会返回到使用通过系统属性“javax.net.ssl.keyStore*”定义的系统范围的密钥存储。

clientCertificateKeyStoreType

Key store type for client certificates.
[CR]NULL or empty means use the default, which is \"JKS\". Standard key store types supported by the JVM are \"JKS\" and \"PKCS12\", 
your environment may have more available depending on what security products are installed and available to the JVM.",

客户端证书的密钥存储类型。
[CR]NULL或空表示使用默认值，即“JKS\”。JVM支持的标准密钥存储类型是“JKS\”和“PKCS12\”，
您的环境可能有更多的可用性，这取决于安装了哪些安全产品并且JVM可以使用这些产品。",

clientCertificateKeyStoreUrl

URL for the client certificate KeyStore[CR]If not specified, the property 'fallbackToSystemKeyStore' determines if system-wide key store is used.

客户端证书KeyStore的URL[CR]如果未指定，属性“fallbackToSystemKeyStore”将确定是否使用系统范围的密钥存储。

clientCertificateKeyStorePassword

Password for the client certificates key store.

客户端证书密钥存储的密码。

fallbackToSystemKeyStore

Whether the absence of setting a value for 'clientCertificateKeyStoreUrl' falls back to using the system-wide key store defined through the system properties 'javax.net.ssl.keyStore*'."

没有为“clientCertificateKeyStoreUrl”设置值是否会返回到使用通过系统属性“javax.net.ssl.keyStore*”定义的系统范围的密钥存储。"

对应关系梳理

sslMode	含义	useSSL	requireSSL	verifyServerCertificate
DISABLED	禁用：建立未加密的连接	false
PREFERRED	首选：（默认）如果服务器启用了加密连接，则建立加密连接，否则返回到未加密连接	true	false	false
REQUIRED	必须：如果服务器启用了安全连接，则建立安全连接，否则将失败	true	true	false
VERIFY_CA	验证授权：类似于“REQUIRED\”，但还要根据配置的证书颁发机构（CA）证书验证服务器TLS证书；	true		true
VERIFY_IDENTITY	验证身份：类似于“VERIFY_CA\”，但还要验证服务器证书是否与尝试连接的主机匹配。

这篇关于MySQL JDBC连接串中sslMode含义、与useSSL、requireSSL的关系的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！

---