证书替换

操作场景

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

前提条件

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

注意事项

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

操作步骤

准备证书、私钥。
服务端各个配置文件名称约定：
- 证书名称约定：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。
制作压缩包。
压缩包名称约定：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。
调用接口，执行替换。
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
```
重启openGauss。
```
gs_om -t stop 
gs_om -t start
```
说明：
证书具有rollback功能，可以把上一次执行证书替换之前的证书，进行回退。可以使用gs_om -t cert --rollback进行远程调用该接口；使用gs_om -t cert --rollback -L进行本地调用该接口。以上一次成功执行证书替换后，被替换的证书版本为基础进行回退。