Skip to content

Latest commit

 

History

History
145 lines (120 loc) · 7.99 KB

CHANGES-ZH.md

File metadata and controls

145 lines (120 loc) · 7.99 KB

更新日志

[未发布]

[2.0.0] - 2020-09-29

新增

改动

  • 配置指令合并 (ba92cfd)。这些配置指令将被合并:waf_check_ipv4waf_check_urlwaf_check_argswaf_check_uawaf_check_refererwaf_check_cookiewaf_check_postwaf_check_cookiewaf_cc_deny。合并后的新指令为waf_mode,详情见README

修复

  • 删除一个默认的 User-Agent 规则,规则内容为(?i)(?:Sogou web spider),原因是会拦截非恶意的网络爬虫(827d4e5)。
  • 现在可以正确处理规则文件中的空行了(955cf2d)。

[1.0.1] - 2020-08-22

新增

  • 增加了新的配置项(3214fc8
    • waf_check_ipv4:
      • 配置语法: waf_check_ipv4 [ on | off ];
      • 默认值:on
      • 配置段: server
      • 作用:是否启用 IPV4 检查。
    • waf_check_url:
      • 配置语法: waf_check_url [ on | off ];
      • 默认值:on
      • 配置段: server
      • 作用:是否启用 URL 检查。
    • waf_check_args:
      • 配置语法: waf_check_args [ on | off ];
      • 默认值:on
      • 配置段: server
      • 作用:是否启用 Args 检查。
    • waf_check_ua:
      • 配置语法: waf_check_ua [ on | off ];
      • 默认值:on
      • 配置段: server
      • 作用:是否启用 User-Agent 检查。
    • waf_check_referer:
      • 配置语法: waf_check_referer [ on | off ];
      • 默认值:on
      • 配置段: server
      • 作用:是否启用 Referer 检查。
    • waf_check_cookie:
      • 配置语法: waf_check_cookie [ on | off ];
      • 默认值:on
      • 配置段: server
      • 作用:是否启用 Cookie 检查。
    • waf_check_post:
      • 配置语法: waf_check_post [ on | off ];
      • 默认值:off
      • 配置段: server
      • 作用:是否启用 POST 检查。
    • waf_cc_deny:
      • 配置语法: waf_cc_deny [ on | off ];
      • 默认值:off
      • 配置段: server
      • 作用:是否启用 CC 防御。

改动

  • waf_mult_mount现在只允许写在server段中(3214fc8)。
    • waf_mult_mount:
      • 配置语法: waf_mult_mount [ on | off ];
      • 默认值:off
      • 配置段: server
      • 作用:进行多阶段检查,当nginx.conf存在地址重写的情况下(如rewrite配置)建议启用,反之建议关闭。
  • 更改现有的配置项关键字,删除了ngx_前缀(8b3e416)。
    • waf:
      • 配置语法: waf [ on | off ];
      • 默认值:off
      • 配置段: server
      • 作用:是否启用本模块。
    • waf_rule_path:
      • 配置语法: waf_rule_path dir;
      • 默认值:无
      • 配置段: server
      • 作用:规则文件所在目录,且必须以/结尾。
    • waf_mult_mount:
      • 配置语法: waf_mult_mount [ on | off ];
      • 默认值:off
      • 配置段: http
      • 作用:进行多阶段检查,当nginx.conf存在地址重写的情况下(如rewrite配置)建议启用,反之建议关闭。
  • 更新 referer 的默认规则,具体一点就是拷贝rules/url的内容到rules/referer中(55f5e26)。

修复

  • 修复 CC 防御功能检测逻辑的错误,该错误会导致实际的频率限制要远小于用户指定的限制,容易将正常访问识别为 CC 攻击(9cb51bb)(171721c)。
  • 现在会检查 rules/ipv4 和 rules/white-ipv4 这两个文件中的 IPV4 地址或地址块是否合法(fc09f04)(2e7f624)。

[1.0.0] - 2020-08-18

新增

  • 改进日志格式(bd112ec)。基本格式为xxxxx, ngx_waf: [拦截类型][对应规则], xxxxx,具体可看下面的例子。
    2020/01/20 22:56:30 [alert] 24289#0: *30 ngx_waf: [BLACK-URL][(?i)(?:/\.env$)], client: 192.168.1.1, server: example.com, request: "GET /v1/.env HTTP/1.1", host: "example.com", referrer: "http:/example.com/v1/.env"
    
    2020/01/20 22:58:40 [alert] 24678#0: *11 ngx_waf: [BLACK-POST][(?i)(?:select.+(?:from|limit))], client: 192.168.1.1, server: example.com, request: "POST /xmlrpc.php HTTP/1.1", host: "example.com", referrer: "https://example.com/"
    
  • 新增三个内置变量(92d6d84
    • $waf_blocked: 本次请求是否被本模块拦截,如果拦截了则其的值为'true',反之则为'false'
    • $waf_rule_type:如果本次请求被本模块拦截,则其值为触发的规则类型。下面是可能的取值。若没有生效则其值为'null'
      • 'BLACK-IPV4'
      • 'BLACK-URL'
      • 'BLACK-ARGS'
      • 'BLACK-USER-AGENT'
      • 'BLACK-REFERER'
      • 'BLACK-COOKIE'
      • 'BLACK-POST'
    • '$waf_rule_details':如果本次请求被本模块拦截,则其值为触发的具体的规则的内容。若没有生效则其值为'null'
  • 支持过滤 POST 请求(b46641e)。
  • 新配置项ngx_waf_mult_mount用于增加拦截面(e1b500d),典型的应用场景是存在rewrite的情况下重写前后均会对 URL 进行一次检测。
  • 支持 CC 防御功能(3a93e19)。

改动

修复

  • IPV4 黑白名单功能失效(231f94a)。
  • 当 User-agent 为空时会触发 segmentation fault(bf33b36)。
  • 启用 CC 防御后会有内存泄漏(be58d18)。