Menu

文档

证书替换

操作场景

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进行本地调用该接口。以上一次成功执行证书替换后,被替换的证书版本为基础进行回退。

本文档遵循知识共享许可协议CC 4.0 (http://creativecommons.org/Licenses/by/4.0/)。