RPC 连接认证 - OceanBase 数据库 V4.6.0

RPC 连接认证

更新时间：2026-06-04 16:29:10

功能简介

该功能旨在提升 RPC 通信的安全性。开启 RPC 连接认证后，只有通过认证的客户端才能与 OBServer 节点建立 RPC 连接，这一措施能够有效拦截攻击者的恶意 RPC 报文，防止其被 OBServer 节点执行，从而增强了 OceanBase 数据库的安全防护能力。

在升级兼容性方面，本方案支持灰度升级流程，可以分段平滑升级，不影响业务进程。在升级过程中，高版本与低版本的 OBServer 节点是相互兼容的。即高版本作为客户端能够连接低版本服务端，同时低版本作为客户端也能够连接高版本服务端。升级后，默认情况下不开启 RPC 连接认证，需要手动开启。

OceanBase 数据库 V4.2.0 版本的 RPC 连接认证的功能，只有在启用 pkt-nio 网络框架后才能使用，即在开启 RPC 连接认证之前需要保证 _enable_pkt_nio 配置项设置为 True。

_enable_pkt_nio 用于控制 RPC 网络框架 pkt-nio 的启用和关闭，默认值为 True。

目前 OBServer 节点提供基于 SSL 握手的 RPC 连接认证，开启方式如下。

需要在安装目录下创建 wallet 文件夹并将证书和私钥文件放入该文件夹。证书和私钥文件包括根证书（ca.pem）、证书（server-cert.pem）、私钥（server-key.pem）三个文件。

以 sys 租户身份登录 OceanBase 数据库，依次执行如下命令。

选择 SSL 协议的版本号。目前支持的 SSL 协议的版本号包括 TLSv1、TLSv1.1、TLSv1.2 和 TLSv1.3，当指定版本号后，支持指定的版本号及其以上的版本协议。有关开启 SSL 连接的更多信息，请参见 sql_protocol_min_tls_version。
```
ALTER SYSTEM SET sql_protocol_min_tls_version = 'TLSv1.1';
```
开启 SSL 连接。有关开启 SSL 连接的更多信息，请参见 ssl_client_authentication。
```
ALTER SYSTEM SET ssl_client_authentication=True;
```
将客户端的认证方式设置为 SSL_NO_ENCRYPT。有关客户端认证的详细信息，请参见 rpc_client_authentication_method。
```
ALTER SYSTEM SET rpc_client_authentication_method = 'SSL_NO_ENCRYPT';
```
将服务端的认证方式设置为 SSL_NO_ENCRYPT。有关服务端认证的详细信息，请参见 rpc_server_authentication_method。
```
ALTER SYSTEM SET rpc_server_authentication_method = 'SSL_NO_ENCRYPT';
```
注意

虽然将服务端认证方式设置为 ALL（即 ALTER SYSTEM SET rpc_server_authentication_method = 'ALL'; ）也可以开启认证，但这也意味着服务端允许客户端不进行认证直接连接，存在较大的安全风险。因此，在生产环境下不建议采用这种方式。

将客户端的认证方式设置为 NONE。

ALTER SYSTEM SET rpc_client_authentication_method = 'NONE';

将服务端的认证方式设置为 NONE 或 ALL。

ALTER SYSTEM SET rpc_server_authentication_method = 'NONE';
--或者
ALTER SYSTEM SET rpc_server_authentication_method = 'ALL';