证书替换

操作场景

openGauss默认配置了SSL连接所需要的安全的证书、私钥，用户如果需要替换为自己的证书、私钥则可按照此方法进行替换。

前提条件

用户需要从CA认证中心申请到正式的服务器、客户端的证书和密钥。

注意事项

openGauss目前只支持X509v3的PEM格式证书。

操作步骤

1. 准备证书、私钥。

   服务端各个配置文件名称约定：

   • 证书名称约定：server.crt。
   • 私钥名称约定：server.key。
   • 私钥密码加密文件约定：server.key.cipher、server.key.rand。

   客户端各个配置文件名称约定：

   • 证书名称约定：client.crt。
   • 私钥名称约定：client.key。
   • 私钥密码加密文件约定：client.key.cipher、client.key.rand。
   • 根证书名称约定：cacert.pem。
   • 吊销证书列表文件名称约定：sslcrl-file.crl。

2. 制作压缩包。

   压缩包名称约定：db-cert-replacement.zip。

   压缩包格式约定：ZIP。

   压缩包文件列表约定：server.crt、server.key、server.key.cipher、server.key.rand、client.crt、client.key、client.key.cipher、client.key.rand、cacert.pem。如果需要配置吊销证书列表，则列表中包含sslcrl-file.crl。

3. 调用接口，执行替换。

   a. 将制作好的压缩包db-cert-replacement.zip上传到openGauss用户下的任意路径。

   例如：/home/xxxx/db-cert-replacement.zip。

   b. 调用如下命令进行替换。

   gs_om -t cert --cert-file= /home/xxxx/db-cert-replacement.zip

4. 重启openGauss。

   gs_om -t stop 
   gs_om -t start

   说明：
   证书具有rollback功能，可以把上一次执行证书替换之前的证书，进行回退。可以使用gs_om -t cert --rollback进行远程调用该接口；使用gs_om -t cert --rollback -L进行本地调用该接口。以上一次成功执行证书替换后，被替换的证书版本为基础进行回退。