跳到主要内容

参数

请参阅插件通用配置,了解所有插件可用的配置选项。

  • mode

    string


    default: block


    vaild vaule:

    off, monitor, or block


    确定插件对匹配请求的行为模式。

    off 模式下,跳过 WAF 检查。在 monitor 模式下,记录潜在威胁的请求但不阻止。在 block 模式下,具有威胁的请求将按照 WAF 服务的决定被阻止。

  • match

    array[object]


    匹配规则数组。插件使用这些规则来决定是否对请求执行 WAF 检查。如果列表为空,则处理所有请求。

    • vars

      array[array]


      一个或多个匹配条件数组,格式为 APISIX 表达式,用于有条件地执行插件。

  • append_waf_resp_header

    boolean


    default: true


    如果为 true,则添加响应头 X-APISIX-CHAITIN-WAFX-APISIX-CHAITIN-WAF-TIMEX-APISIX-CHAITIN-WAF-ACTIONX-APISIX-CHAITIN-WAF-STATUS

  • append_waf_debug_header

    boolean


    default: false


    如果为 true,则在响应中添加调试头 X-APISIX-CHAITIN-WAF-ERRORX-APISIX-CHAITIN-WAF-SERVER。仅当 append_waf_resp_headertrue 时有效。

  • config

    object


    Chaitin WAF 服务配置。指定时,这些设置会覆盖相应的元数据默认值。

    • connect_timeout

      integer


      default: 1000


      到 WAF 服务的连接超时时间,单位为毫秒。

    • send_timeout

      integer


      default: 1000


      向 WAF 服务发送数据的超时时间,单位为毫秒。

    • read_timeout

      integer


      default: 1000


      从 WAF 服务接收数据的读取超时时间,单位为毫秒。

    • req_body_size

      integer


      default: 1024


      允许的最大请求体大小,单位为 KB。

    • keepalive_size

      integer


      default: 256


      可以并发维护的到 WAF 检测服务的最大空闲连接数。

    • keepalive_timeout

      integer


      default: 60000


      WAF 服务的空闲连接超时时间,单位为毫秒。

    • real_client_ip

      boolean


      default: true


      如果为 true,则从 X-Forwarded-For 头获取客户端 IP。如果为 false,则插件使用连接中的客户端 IP。

插件元数据

  • nodes

    array[object]


    required


    Chaitin WAF 服务的地址数组。

    • host

      string


      required


      Chaitin WAF 服务地址。支持 IPv4、IPv6、Unix Socket 等。

    • port

      integer


      default: 80


      Chaitin WAF 服务端口。

  • mode

    string


    default: block


    确定插件对匹配请求的行为模式。

    off 模式下,跳过 WAF 检查。在 monitor 模式下,记录潜在威胁的请求但不阻止。在 block 模式下,具有威胁的请求将按照 WAF 服务的决定被阻止。

  • config

    object


    Chaitin WAF 服务配置。

    • connect_timeout

      integer


      default: 1000


      到 WAF 服务的连接超时时间,单位为毫秒。

    • send_timeout

      integer


      default: 1000


      向 WAF 服务发送数据的超时时间,单位为毫秒。

    • read_timeout

      integer


      default: 1000


      从 WAF 服务接收数据的读取超时时间,单位为毫秒。

    • req_body_size

      integer


      default: 1024


      允许的最大请求体大小,单位为 KB。

    • keepalive_size

      integer


      default: 256


      可以并发维护的到 WAF 检测服务的最大空闲连接数。

    • keepalive_timeout

      integer


      default: 60000


      WAF 服务的空闲连接超时时间,单位为毫秒。

    • real_client_ip

      boolean


      default: true


      如果为 true,则从 X-Forwarded-For 头获取客户端 IP。如果为 false,则插件使用连接中的客户端 IP。