通过JDBC连接实例的方式有无需下载SSL证书连接和用户下载SSL证书连接两种，其中使用SSL证书连接通过了加密功能，具有更高的安全性。TaurusDB新实例默认开启SSL数据加密，SSL连接实现了数据加密功能，但同时会增加网络连接响应时间和CPU消耗，请评估对业务的性能影响，根据需要进行设置。

前提条件

用户需要具备以下技能：

• 熟悉计算机基础知识。
• 了解java编程语言。
• 了解JDBC基础知识。

使用SSL证书连接

使用SSL证书连接实例，即通过证书校验并连接数据库。

                    
说明
                    
以下提供的方式不适用于数据库用户的ssl_type为x509的认证方式。
执行命令查看当前用户的ssl_type值：
select ssl_type from mysql.user where user = 'xxx';
                    
                  
                  

步骤 1 下载CA证书或捆绑包。

1. 在“实例管理”页面，单击实例名称进入“基本信息”页面。
2. 在“数据库信息”区域，单击“SSL”开关右侧的。

步骤 2 使用keytool工具通过CA证书生成truststore文件。

<keytool工具的安装路径> ./keytool.exe -importcert -alias <MySQLCACert> -­file <ca.pem> -keystore <truststore_file> -storepass <password>

表 变量说明

代码示例（使用JDK安装路径下的keytool工具生成truststore文件）：

Owner:  CN=MySQL_Server_8.0.22_Auto_Generated_CA_Certificate 
Issuer: CN=MySQL_Server_8.0.22_Auto_Generated_CA_Certificate  
Serial number: 1 
Valid from: Thu Feb 16 11:42:43 EST 2017 until: Sun Feb 14 11:42:43 EST 2027  
Certificate fingerprints: 
     MD5: 18:87:97:37:EA:CB:0B:5A:24:AB:27:76:45:A4:78:C1 
     SHA1: 2B:0D:D9:69:2C:99:BF:1E:2A:25:4E:8D:2D:38:B8:70:66:47:FA:ED  
     SHA256:C3:29:67:1B:E5:37:06:F7:A9:93:DF:C7:B3:27:5E:09:C7:FD:EE:2D:18:86:F4:9C:40:D8:26:CB:DA:95: A0:24 
     Signature algorithm name: SHA256withRSA Subject Public Key Algorithm: 2048-bit RSA key  
     Version: 1 
     Trust this certificate? [no]: y 
     Certificate was added to keystore

步骤 3 通过JDBC连接TaurusDB数据库，代码中的JDBC链接格式如下：

jdbc:mysql://<instance_ip>:<instance_port>/<database_name>?  
requireSSL=<value1>&useSSL=<value2>&verifyServerCertificate=<value3>&trustCertificateKeyStoreUrl=file:  
<truststore_file>&trustCertificateKeyStorePassword=<password>

表 参数说明

表 连接参数与SSL Mode的关系说明

代码示例（连接TaurusDB数据库的java代码）：

import java.sql.Connection;  
import java.sql.DriverManager;  
import java.sql.ResultSet;  
import java.sql.Statement; 
import java.sql.SQLException;  
  
public class JDBCTest {  
    static final String USER = "xxx";  
    static final String PASS = "xxx"; 
 
    public static void main(String[] args) { 
        Connection conn = null;  
        Statement stmt = null; 
 
        String url = "jdbc:mysql://<instance_ip>:<instance_port>/<database_name>? 
requireSSL=true&useSSL=true&verifyServerCertificate=true&trustCertificateKeyStoreUrl=file: 
<truststore_file>&trustCertificateKeyStorePassword=<password>"; 
  
        try {  
            Class.forName("com.mysql.cj.jdbc.Driver"); 
            conn = DriverManager.getConnection(url, USER, PASS); 
  
            stmt = conn.createStatement();  
            String sql = "show status like 'ssl%'"; 
            ResultSet rs = stmt.executeQuery(sql);  
 
            int columns = rs.getMetaData().getColumnCount(); 
            for (int i = 1; i <= columns; i++) { 
                System.out.print(rs.getMetaData().getColumnName(i)); 
                System.out.print("\t"); 
            } 
 
            while (rs.next()) {  
                System.out.println();  
                for (int i = 1; i <= columns; i++) { 
                    System.out.print(rs.getObject(i)); 
                    System.out.print("\t"); 
                }  
            } 
            rs.close();  
            stmt.close();  
            conn.close();  
        } catch (SQLException se) {  
            se.printStackTrace();  
        } catch (Exception e) {  
            e.printStackTrace();  
        } finally {  
            // release resource ....  
        }  
    }  
}

无证书连接

                    
说明
                    
该方式不对服务端进行证书校验，用户无需下载SSL证书。
                    
                  
                  

步骤 1 通过JDBC连接TaurusDB数据库实例，代码中的JDBC链接格式如下：

jdbc:mysql://<instance_ip>:<instance_port>/<database_name>?useSSL=false

表 变量说明

代码示例（连接TaurusDB数据库的java代码）：

import java.sql.Connection; 
import java.sql.DriverManager; 
import java.sql.ResultSet; 
import java.sql.Statement; 
 
public class MyConnTest { 
	final public static void main(String[] args) { 
		Connection conn = null; 
		// set sslmode here. 
		// no ssl certificate, so do not specify path. 
		String url = "jdbc:mysql://192.168.0.225:3306/my_db_test?useSSL=false"; 
		try { 
			Class.forName("com.mysql.jdbc.Driver"); 
			conn = DriverManager.getConnection(url, "root", "password"); 
			System.out.println("Database connected"); 
 
			Statement stmt = conn.createStatement(); 
			ResultSet rs = stmt.executeQuery("SELECT * FROM mytable WHERE columnfoo = 500"); 
			while (rs.next()) { 
				System.out.println(rs.getString(1)); 
			} 
			rs.close(); 
			stmt.close(); 
			conn.close(); 
		} catch (Exception e) { 
			e.printStackTrace(); 
			System.out.println("Test failed"); 
		} finally { 
			// release resource .... 
		} 
	} 
}

相关问题

• 问题描述当您使用8.0及以上版本的JDK通过SSL证书模式连接TaurusDB时，报如下类似错误：

  javax.net.ssl.SSLHandshakeException: No appropriate protocol (protocol is disabled or 
  cipher suites are inappropriate) 
      at sun.security.ssl.HandshakeContext.<init>(HandshakeContext.java:171) ~[na:1.8.0_292] 
      at sun.security.ssl.ClientHandshakeContext.<init>(ClientHandshakeContext.java:98) ~ 
  [na:1.8.0_292] 
      at sun.security.ssl.TransportContext.kickstart(TransportContext.java:220) ~ 
  [na:1.8.0_292] 
      at sun.security.ssl.SSLSocketImpl.startHandshake(SSLSocketImpl.java:428) ~ 
  [na:1.8.0_292] 
      at 
  com.mysql.cj.protocol.ExportControlled.performTlsHandshake(ExportControlled.java:316) ~ 
  [mysql-connector-java-8.0.17.jar:8.0.17] 
      at 
  com.mysql.cj.protocol.StandardSocketFactory.performTlsHandshake(StandardSocketFactory.java 
  :188) ~[mysql-connector-java8.0.17.jar:8.0.17] 
      at 
  com.mysql.cj.protocol.a.NativeSocketConnection.performTlsHandshake(NativeSocketConnection. 
  java:99) ~[mysql-connector-java8.0.17.jar:8.0.17] 
      at 
  com.mysql.cj.protocol.a.NativeProtocol.negotiateSSLConnection(NativeProtocol.java:331) ~ 
  [mysql-connector-java8.0.17.jar:8.0.17] 
  ... 68 common frames omitted
  

• 解决方法您可以在步骤3中的代码链路中，根据客户端使用的Jar包指定对应参数值进行连接。示例如下：
  • mysql-connector-java-5.1. xx .jar

    jdbc:mysql://<instance_ip>:<instance_port>/<database_name>?  
     requireSSL=true&useSSL=true&verifyServerCertificate=true&trustCertificateKeyStoreUrl=file:  
     <truststore_file>&trustCertificateKeyStorePassword=<password>& enabledTLSProtocols=TLSv1.2
    

  • mysql-connector-java-8.0. xx .jar

    jdbc:mysql://<instance_ip>:<instance_port>/<database_name>?  
     requireSSL=true&useSSL=true&verifyServerCertificate=true&trustCertificateKeyStoreUrl=file:  
     <truststore_file>&trustCertificateKeyStorePassword=<password>& tlsVersions =TLSv1.2