UBSIO-BoostIO 配置说明 ​

本文档说明 UBSIO-BoostIO 的 bio.conf 配置项和 TLS 认证配置。软件安装与启动流程请参见安装部署指南。

bio.conf 配置项 ​

根据业务使用情况和待安装部署的环境，设置 /etc/boostio/bio.conf 中的相关配置项。

UBSIO-BoostIO 配置项

TLS 认证配置 ​

开启Server端TLS认证 ​

注意事项

• 如需开启TLS认证，则UBS IO集群中的所有计算节点均需开启TLS认证。

• 安装部署完成后，需手动删除安装过程中用于集群节点间通信的公钥。

• 生成加密口令之前建议关闭系统历史记录功能。口令生成后可重新启用该功能。

  用户导入的私钥最好进行加密，否则会有安全风险。

  证书安全要求：

  • 需使用业界公认安全可信的非对称加密算法、密钥长度、Hash算法、证书格式等。
  • 应处于有效期内。

• TLS加密配置有如下三种使用方式。

  • （推荐）提供包含指定签名的解密函数so，提供加密后的口令和加密私钥，根据解密函数对口令进行解密。
  • 不提供解密函数so，提供明文口令和加密私钥。
  • 不提供解密函数so和口令，仅提供未加密的私钥。

前提条件

UBS IO已经安装成功，需给予Server用户相应的权限读取下面文件。首先获取TLS认证需要的文件，如表1所示。

表 1 开启Server端TLS认证所需文件列表

操作步骤

1. 修改bio.conf配置文件。
2. 打开网络安全开关。请参见UBSIO-BoostIO 配置项，将bio.net.tls.enable.switch配置为true。
3. 请参见表1，将准备好的相关证书的路径写入到配置文件中的相应选项。

开启Client端TLS认证 ​

注意事项

• 分离部署时才需要此步骤，TLS开关（enableTls）由用户传入，建议用户开启TLS认证，UBS IO所有节点的TLS认证开启和关闭保持统一。
• 集群中所有的Client端和Server端需要同步开启或关闭TLS认证，否则会连接失败。
• 多用户访问UBS IO服务时，每个用户使用的证书可以是不同的，但需要满足都由同一个CA签发。
• Client和Server的所有节点应使用相同的加密配置方式。

前提条件

UBS IO已经安装成功，需给予Client用户相应的权限读取下面文件。首先获取TLS认证需要的文件，如表1所示。

表 1 开启Client端TLS认证所需文件列表

操作步骤

1. 获取相应的软件包。

2. 调用初始化接口即可获取表1的文件。详情请参见 UBSIO-BoostIO API 参考的 BioInitialize 章节。

   config

   TLS涉及到的参数的成员如下：
   uint8_t enable;                    // switch
   char certificationPath[PATH_MAX];  // certification path
   char caCerPath[PATH_MAX];          // caCer path
   char caCrlPath[PATH_MAX];          // caCrl path
   char privateKeyPath[PATH_MAX];     // private key path
   char privateKeyPassword[PATH_MAX]; // private key password
   char decrypterLibPath[PATH_MAX];   // decrypter lib path
   char opensslLibDir[PATH_MAX];      // openssl lib dir path