请求屏蔽
功能说明
request-block
插件实现了基于 URL、请求头等特征屏蔽 HTTP 请求,可以用于防护部分站点资源不对外部暴露
运行属性
插件执行阶段:鉴权阶段
插件执行优先级:320
配置字段
名称 | 数据类型 | 填写要求 | 默认值 | 描述 |
---|---|---|---|---|
block_urls | array of string | 选填,block_urls ,block_exact_urls ,block_regexp_urls ,block_headers ,block_bodies 中至少必填一项 | - | 配置用于匹配需要屏蔽 URL 的字符串 |
block_exact_urls | array of string | 选填,block_urls ,block_exact_urls ,block_regexp_urls ,block_headers ,block_bodies 中至少必填一项 | - | 配置用于匹配需要精确屏蔽 URL 的字符串 |
block_regexp_urls | array of string | 选填,block_urls ,block_exact_urls ,block_regexp_urls ,block_headers ,block_bodies 中至少必填一项 | - | 配置用于匹配需要屏蔽 URL 的正则表达式 |
block_headers | array of string | 选填,block_urls ,block_exact_urls ,block_regexp_urls ,block_headers ,block_bodies 中至少必填一项 | - | 配置用于匹配需要屏蔽请求 Header 的字符串 |
block_bodies | array of string | 选填,block_urls ,block_exact_urls ,block_regexp_urls ,block_headers ,block_bodies 中至少必填一项 | - | 配置用于匹配需要屏蔽请求 Body 的字符串 |
blocked_code | number | 选填 | 403 | 配置请求被屏蔽时返回的 HTTP 状态码 |
blocked_message | string | 选填 | - | 配置请求被屏蔽时返回的 HTTP 应答 Body |
case_sensitive | bool | 选填 | true | 配置匹配时是否区分大小写,默认区分 |
配置示例
屏蔽请求 url 路径
根据该配置,下列请求将被禁止访问:
屏蔽精确匹配的请求 url 路径
根据该配置,下列请求将被禁止访问:
屏蔽正则匹配的请求 url 路径
根据该配置,下列请求将被禁止访问:
屏蔽请求 header
根据该配置,下列请求将被禁止访问:
屏蔽请求 body
根据该配置,下列请求将被禁止访问:
请求 Body 大小限制
当配置了 block_bodies
时,仅支持小于 32 MB 的请求 Body 进行匹配。若请求 Body 大于此限制,并且不存在匹配到的 block_urls
和 block_headers
项时,不会对该请求执行屏蔽操作
当配置了 block_bodies
时,若请求 Body 超过全局配置 DownstreamConnectionBufferLimits,将返回 413 Payload Too Large