列表与对象:字符串集合
列表与对象:把多条规则共用的路径、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 指纹只能用“完全相等”且“区分大小写”的集合,其他集合在这里置灰。
平台集合是什么
由平台管理员维护、所有用户的规则都可以引用的集合,在列表里标为“平台”,你只能查看。