#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将导致数据库实例启动失败。