From 021024e6dc2b73a65f1014e0310ff72c170b64d5 Mon Sep 17 00:00:00 2001 From: yihaoDeng Date: Fri, 8 Nov 2024 17:17:47 +0800 Subject: [PATCH] add ip white list read --- docs/zh/08-operation/16-security.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/zh/08-operation/16-security.md b/docs/zh/08-operation/16-security.md index 4f47a644f7..1c8ad2200f 100644 --- a/docs/zh/08-operation/16-security.md +++ b/docs/zh/08-operation/16-security.md @@ -26,6 +26,22 @@ SHOW USERS; ```sql ALTER USER TEST DROP HOST HOST_NAME1 ``` +说明 +1. 开源版和企业版本都能添加成功，且可以查询到，但是开源版本不会对IP做任何限制。 +2. create user u_write pass 'taosdata1' host 'iprange1','iprange2', 可以一次添加多个iprange, 服务端会做去重，去重的逻辑是需要iprange 完全一样 +3. 默认会把127.0.0.1 添加到白名单列表，且在白名单列表可以查询 +4. 集群的节点IP集合会自动添加到白名单列表，但是查询不到。 +5. taosadaper 和 taosd 不在一个机器的时候，需要把taosadaper IP手动添加到taosd 白名单列表中 +6. 集群情况下，各个节点 enableWhiteList 成一样，或者全为false,或者全为true, 要不然集群无法启动 +7. 白名单变更生效时间1s，不超过2s, 每次变更对收发性能有些微影响（多一次判断，可以忽略），变更完之后、影响忽略不计, 变更过程中对集群没有影响，对正在访问客户端也没有影响（假设这些客户端的IP包含在white list内） +8. 如果添加两个ip range, 192.168.1.1/16(假设为A), 192.168.1.1/24(假设为B), 严格来说，A包含了B，但是考虑情况太复杂，并不会对A和B做合并 +9. 要删除的时候，必须严格匹配。 也就是如果添加的是192.168.1.1/24, 要删除也是192.168.1.1/24 +10. 只有root 才有权限对其他用户增删ip white list +11. 兼容之前的版本，但是不支持从当前版本回退到之前版本 +12. x.x.x.x/32 和x.x.x.x 属于同一个iprange, 显示为x.x.x.x +13. 如果客户端拿到的 0.0.0.0/0, 说明没有开启白名单。 +14. 如果白名单发生了改变， 客户端会在heartbeat里检测到。 +15. 针对一个user, 添加的IP个数上限是2048 ## 审计日志