查看文档目录

列表与对象:字符串集合

列表与对象:把多条规则共用的路径、UA、域名放进一份字符串集合,改一处,所有引用它的 WAF 规则同时生效。

作用

字符串集合是一份有名字的成员清单,加上一种匹配方式。WAF 规则的条件可以写成“某个字段在这份集合里”或“不在这份集合里”,不必把成员逐条抄进每条规则。集合改动后,引用它的网站自动重新发布。

使用场景

  • 同一批后台路径(如 /admin、/manage/)要在多个网站、多条规则里统一拦截或放行。
  • 一批可信的 User-Agent 前缀需要在几条规则里共用。
  • 一批要拦截的来源域名(Referer)需要随时增删。

在哪里配置

控制台菜单“列表与对象”,切到“字符串集合”页签,点击“字符串集合”新建。IP 名单在同一页的另一个页签。规则里的使用方式:安全策略的规则编辑器,条件字段选路径、User-Agent、Referer、域名、请求头、请求 URI 或 JA4,操作符选“在字符串集合中”或“不在字符串集合中”,再选择集合。

配置项

配置项说明
名称同一账号下不能重名
描述选填
匹配方式完全相等、前缀、后缀、包含、通配符;创建后不能修改
区分大小写默认区分;不区分时只把 A–Z 转成小写再比较
成员每行一个;保存时去掉首尾空格、去重并排序

匹配方式示例:

方式含义示例
完全相等值与某个成员完全相同/admin
前缀值以某个成员开头/api/ 命中 /api/v1
后缀值以某个成员结尾.php
包含值里含有某个成员sqlmap
通配符* 匹配任意多个字符,? 匹配一个字节/api/*/users

数量与格式:每个成员不超过 512 字节,UTF-8 文本,不含控制字符;成员合计不超过 256 KiB;通配符集合最多 2000 个成员,其他最多 10000 个;通配符成员最多 3 个 *;每个账号最多 200 份集合。一条规则里最多放 4 个字符串集合条件。

常见问题

集合被规则引用,能删除吗

不能。控制台显示被几条策略引用,并可以“查看引用”跳到对应策略;先在规则里去掉引用再删除。

想临时停用一份白名单

停用引用它的规则,不要清空集合:集合至少要有一个成员。

前缀 /api 为什么也命中 /apiary

前缀按字符比较。只想匹配目录时,成员写成 /api/。

JA4 条件的集合下拉里有些选项是灰的

JA4 指纹只能用“完全相等”且“区分大小写”的集合,其他集合在这里置灰。

平台集合是什么

由平台管理员维护、所有用户的规则都可以引用的集合,在列表里标为“平台”,你只能查看。