GaussDB-连接数据库（以SSL方式）

CY 学数据库 2023-09-05

用户通过JDBC连接GaussDB服务器时，可以通过开启SSL加密客户端和服务器之间的通讯，为敏感数据在Internet上的传输提供了一种安全保障手段。

本小节主要介绍应用程序通过JDBC如何采用SSL的方式对客户端进行配置（服务端配置请联系管理员）。

在使用本小节所描述的方法前，默认用户已经获取了服务端和客户端所需要的证书和私钥文件，关于证书等文件的获取请参考Openssl相关文档和命令。

客户端配置

不同于基于gsql的程序，JDBC默认支持服务证书确认，如果用户使用一个由认证中心（CA，全球CA或区域CA）签发的证书，则java应用程序不需要做什么，因为java拥有大部分认证中心签发的证书的拷贝。如果用户使用的是自签的证书，则需要配置客户端程序，使其可用，此过程依赖于openssl工具以及java自带的keytool工具，配置步骤如下：

说明：

如果使用内置证书，以下步骤有效。

在客户端机器上，上传证书文件。
1. 以普通用户登录客户端机器。
2. 创建“/tmp/cacert”目录。
```
mkdir /tmp/cacert
```
3. 将根证书文件以及客户端证书和私钥文件放入所创建的目录下。
将根证书导入到trustStore中。
```
openssl x509 -in cacert.pem -out cacert.crt.der -outform der
```
生成中间文件cacert.crt.der。
```
keytool -keystore mytruststore -alias cacert -import -file cacert.crt.der
```
请用户根据提示信息输入口令，此口令为truststorepassword，例如xxxxxxxxx，从而生成mytruststore。
- cacert.pem为根证书。
- cacert.crt.der为中间文件。
- mytruststore为生成的密钥库名称，此名称以及别名，用户可以根据需要进行修改。

将客户端证书和私钥导入到keyStore中。

openssl pkcs12 -export -out client.pkcs12 -in client.crt -inkey client.key

请用户根据提示信息输入clientkey，例如xxxxxxxxx，从而生成client.pkcs12。

keytool -importkeystore -deststorepass xxxxxxxxxxx -destkeystore client.jks -srckeystore client.pkcs12 -srcstorepass xxxxxxxxx -srcstoretype PKCS12 -alias 1 -destkeypass xxxxxxxxx

此处deststorepass与destkeypass需保持一致，srcstorepass需与上条命令中的export password保持一致。生成client.jks。

示例

注：示例1和示例2选择其一。

public class SSL{
    public static void main(String[] args) {
        Properties urlProps = new Properties();
        String urls = "jdbc:postgresql://10.29.37.136:8000/postgres";

        /**
         * ==================  示例1  使用NonValidatingFactory通道
         */
        urlProps.setProperty("sslfactory","org.postgresql.ssl.NonValidatingFactory");
        urlProps.setProperty("user", "world");
        urlProps.setProperty("password", "********");
        urlProps.setProperty("ssl", "true");
        /**
         * ==================  示例2  使用证书
         */
        urlProps.setProperty("sslcert", "client.crt");
        urlProps.setProperty("sslkey", "client.key.pk8");
        urlProps.setProperty("sslrootcert", "cacert.pem");
        urlProps.setProperty("user", "world");
        urlProps.setProperty("ssl", "true");
        /* sslmode可配置为：require、verify-ca、verify-full，以下三个示例选择其一*/
        /* ==================  示例2.1  设置sslmode为require，使用证书 */
        urlProps.setProperty("sslmode", "require");
        /* ==================  示例2.2  设置sslmode为verify-ca，使用证书 */
        urlProps.setProperty("sslmode", "verify-ca");
        /* ==================  示例2.3  设置sslmode为verify-full，使用证书（Linux下验证） */
        urls = "jdbc:postgresql://world:8000/postgres";
        urlProps.setProperty("sslmode", "verify-full");

        try {
            Class.forName("org.postgresql.Driver").newInstance();
        } catch (Exception e) {
            e.printStackTrace();
        }
        try {
            Connection conn;
            conn = DriverManager.getConnection(urls,urlProps);
            conn.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
/**
 * 注：将客户端密钥转化为DER格式:
 * openssl pkcs8 -topk8 -outform DER -in client.key -out client.key.pk8 -nocrypt
 * openssl pkcs8 -topk8 -inform PEM -in client.key -outform DER -out client.key.der -v1 PBE-MD5-DES
 * openssl pkcs8 -topk8 -inform PEM -in client.key -outform DER -out client.key.der -v1 PBE-SHA1-3DES
 * 以上算法由于安全级别较低，不推荐使用。
 * 如果客户需要采用更高级别的私钥加密算法，启用bouncycastle或者其他第三方私钥解密密码包后可以使用的私钥加密算法如下：
 * openssl pkcs8 -in client.key -topk8  -outform DER -out client.key.der -v2 AES128
 * openssl pkcs8 -in client.key -topk8  -outform DER -out client.key.der -v2 aes-256-cbc -iter 1000000
 * openssl pkcs8 -in client.key -topk8 -out client.key.der  -outform Der -v2 aes-256-cbc -v2prf hmacWithSHA512
 * 启用bouncycastle：使用jdbc的项目引入依赖：bcpkix-jdk15on.jar包，版本建议：1.65以上。
 */

gaussdb

「喜欢这篇文章，您的关注和赞赏是给作者最好的鼓励」

关注作者

GaussDB-连接数据库（以SSL方式）

客户端配置

示例

评论