#数据库服务端SSL连接配置

YashanDB启用SSL连接要求由服务器生成根证书、服务器证书和DH文件，客户端获取服务器的根证书，在通讯时进行客户端到服务端的安全验证。

Caution：

• 一旦服务器开启SSL连接，所有的客户端都必须有根证书才能连接到数据库。

• 启用SSL连接和用户密码认证无关联，用户登录数据库仍需输入密码。

# 服务端配置

# 工具准备

生成证书需使用OpenSSL工具，请先参照依赖项准备检查并确保服务器系统中已安装符合要求的工具。

# 生成证书

以下步骤中的工具命令选项、路径、名称等无限制，用户可依据自身环境和需要替换为其他值。

1. 生成根证书（自签名，包含服务端公钥）：

   根证书用于给数据库服务器证书签名，和发送给客户端用于SSL连接验证，本手册生成证书的路径为/home/yashan/YASDB_DATA/config，以该路径为例进行介绍。

   $ openssl req -new -x509 -days 365 -nodes -out root.crt -keyout ca.key -subj "/CN=RootCA"
   

   Copied!

2. 生成根证书请求文件和服务器私钥：

   $ openssl req -new -nodes -text \
   -out server.csr \
   -keyout server.key \
   -subj "/CN=server"
   

   Copied!

3. 生成服务器证书并签名：

   $ openssl x509 -req -in server.csr -text -days 5 \
   -CA root.crt \
   -CAkey ca.key \
   -CAcreateserial \
   -out server.crt
   

   Copied!

4. 生成DH文件：

   $ openssl dhparam -2 -out dhparam.pem -text 2048
   

   Copied!

Note：

根证书或服务器证书过期后，需重新生成证书。

# 配置参数

1. 在数据库打开SSL连接开关，并配置证书路径。其中，路径仅可指定为绝对路径，且最长不超过254字节。

   ALTER SYSTEM SET ssl_enable = ON SCOPE=spfile;
   ALTER SYSTEM SET ssl_cert_file = /home/yashan/YASDB_DATA/config/server.crt SCOPE=spfile;
   ALTER SYSTEM SET ssl_dh_param_file = /home/yashan/YASDB_DATA/config/dhparam.pem SCOPE=spfile;
   ALTER SYSTEM SET ssl_key_file = /home/yashan/YASDB_DATA/config/server.key SCOPE=spfile;
   

   Copied!

2. 重启数据库。

Warn：

如打开了SSL连接开关，但未配置证书路径，或者配置路径不正确，数据库将无法启动。

# 客户端配置

本手册以Linux平台为例介绍客户端配置。

1. 下载服务端根证书，放至本地路径，如/home/yasdb/cert。

2. 在YashanDB客户端文件夹中新建client文件夹，并于client文件夹中新建空文件yasc_env.ini。

   $ mkdir client
   $ cd client
   $ vi yasc_env.ini
   

   Copied!

3. 设置环境变量。

   $ vi ~/.bashrc
   export YASDB_HOME=/home/yasdb/yashandb_client
   $ source ~/.bashrc
   

   Copied!

   Note：

   YASDB_HOME路径需要指向YashanDB客户端文件夹。

4. 在${YASDB_HOME}/client/yasc_env.ini中增加如下配置：

   ssl_root_cer = /home/yasdb/cert/root.crt
   

   Copied!

   其中，配置中的路径可指定为绝对或相对路径，但不能为含有../的相对路径，且系统按前255字节长度进行文件读取。