#IP黑白名单

YashanDB提供IP访问控制功能,以增强数据库访问的安全性,该功能默认关闭,由用户在需要时启用并配置相应的IP黑/白名单列表。

  • 启用并仅配置白名单:仅白名单内的IP向数据库发起的远程连接请求才能被允许。

  • 启用并仅配置黑名单:黑名单内的IP向数据库发起的远程连接请求会被直接拒绝。

  • 启用并同时配置黑名单和白名单:黑名单优先级高于白名单,若黑白名单中存在相同IP按黑名单生效。

Note

本功能仅对远程连接生效,使用UDS本地连接的请求将一直被允许。

# 配置文件

IP黑/白名单通过$YASDB_DATA/config/yasdb_net.ini文件进行配置,重启生效。该文件初始安装后并不存在,需由用户在需要启动本功能时自行创建,文件内容如下:

## 路径为$YASDB_DATA/config/yasdb_net.ini
TCP.VALIDNODE_CHECKING = YES
TCP.INVITED_NODES = 192.168.1.2/16
TCP.EXCLUDED_NODES = 192.168.1.111/32

# 配置参数

TCP.VALIDNODE_CHECKING

是否启用检查白名单,配置为yes表示启用(系统忽略大小写),配置为其他值均表示不启用。

TCP.INVITED_NODES

白名单列表,多个IP以,隔开。

IP的格式为:IP[/MASK],其中,MASK表示从左向右匹配二进制IP的比特数。IPv4地址的MASK取值范围为[0,32],默认为32全匹配;IPv6地址的MASK取值范围为[0,128],默认为128位全匹配。例如127.0.0.1/8表示只匹配IP的第一个字节127,fc00:7::126/64则表示匹配IP的前8个字节。

  • 不允许使用通配符表示IP,例如配置127.*.*.0将被认为是非法IP。
  • 不允许使用域名替换IP。
  • 不允许使用127.0.0.1代指当前服务器(本机)IP,必须使用实际的IP地址。

TCP.EXCLUDED_NODES

黑名单列表,多个IP以,隔开,IP的格式同白名单。

Warn

IP必须配置为上述系统认可的有效格式,非法IP将导致数据库实例启动失败。

pdf-btn 下载文档
copy-btn 复制链接