Suricata 规则缓冲区顺序与 fast_pattern:以 SRS 命令注入检测规则为例
defense/detection · verified
一句话结论
Suricata 的 HTTP 规则采用“粘性缓冲区(sticky buffer)”模型:http.method/http.uri/http.header/http.request_body/file_data/http.response_body 等关键字会切换后续 content/pcre 的匹配上下文,因此必须“先切缓冲区、再写匹配”;把 content 写在缓冲区关键字之前会让它在默认/上一个缓冲区里匹配,造成漏报或误报。用 content 做 AC 自动机快速预筛、pcre 做精确校验,并把 fast_pattern 放在最具区分度的核心特征上,可同时降低误报与 CPU 占用。
原理
- 规则结构:
action proto src src_port -> dst dst_port (options),真正决定“去哪里匹配什么”的是括号内的选项序列;选项以分号分隔,逐项作用于当前匹配缓冲区。 - 粘性缓冲区:Suricata 的
http.method、http.uri、http.uri.raw、http.header、http.request_body、file_data、http.response_body等是粘性缓冲区关键字;它会设置“当前缓冲区”,并影响其后所有content/pcre,直到下一个缓冲区关键字或规则结束。 - 顺序错误的后果:
content:"cmd="; http.request_body;中,content在缓冲区切换之前执行,匹配的是默认缓冲区/上一个缓冲区,而不是请求体;http.request_body; content:"cmd=";才会在请求体里查找。多个content之间若不切换缓冲区,它们会都在同一个缓冲区里匹配。 content与pcre的分工:content是固定字节串匹配,Suricata 用 Aho-Corasick 等多模式匹配做快速预筛;pcre是正则回溯匹配,表达力强但更慢。最佳实践是先用content锁定一个稳定子串,再用pcre做精确语义校验。fast_pattern:Suricata 会从规则中选一个content作为快速预筛模式;fast_pattern显式指定它,fast_pattern:only表示该content仅用于快筛、跳过其内容校验(其他content仍正常匹配)。把它放在出现频率低、区分度高的特征上,能显著减少进入 pcre 的流量。- 短关键字的误报:
content:"id"、content:"ls"这类短串会命中大量正常流量;应加上下文(参数名、分隔符、方法/URI 限定)或改用更长的特征。 - 性能与正确性的关系:顺序不仅改变语义,也改变匹配引擎的工作量;原文给出的 SRS 规则优化案例显示,先限定方法/URI、再在请求体用
content:"action"预筛、最后用pcre校验,可减少进入正则的流量。
触发条件
- 需要为 HTTP 协议编写/优化 Suricata IDS/IPS 规则,尤其是命令注入、文件上传、WebShell 等需要同时看方法、URI、请求体/响应体的场景。
- 规则出现“逻辑正确但不告警”或“告警量异常/CPU 高”的问题,怀疑缓冲区顺序或
fast_pattern配置不当。 - 有可回放的 pcap 与 Suricata 运行环境,能对比规则修改前后的
fast.log/eve.json与性能指标。
利用步骤
- 明确要检测的协议字段:方法、URI(解码/原始)、请求头、请求体、文件内容、响应体;为每个字段选择对应的粘性缓冲区关键字。
- 按“先缓冲区、后匹配”的顺序写规则:每个
content/pcre前都确保当前缓冲区正确;需要切换时重新写缓冲区关键字。 - 用
content选一个稳定、较长的核心子串做预筛;在其后写pcre做精确校验(注意转义、大小写与边界)。 - 在核心
content上加fast_pattern(或fast_pattern:only),避免把短词/通用词设为快速模式。 - 用
suricata -r test.pcap -l /var/log/suricata回放,检查fast.log/eve.json是否命中预期流量、是否误报正常流量。 - 用
tcpreplay/wrk做压力测试,记录触发率、FP/FN、延迟、CPU、内存;修改规则后递增rev。 - 把规则纳入评审清单:缓冲区顺序、content/pcre 分工、fast_pattern、短关键字、rev 递增。
PoC
原文给出的 SRS 命令注入检测规则(原文标注 CVE-2023-34105)对比如下(未在本机运行):
# 原始规则(性能差:pcre 承担主要匹配)
alert http any any -> any any (
msg:"SRS 命令注入 (CVE-2023-34105)";
flow:to_server,established;
http.method; content:"POST";
http.uri.raw; content:"/api/v1/snapshots";
http.request_body; pcre:"/action.*on_publish.*app.*(curl|wget|id|whoami)/i";
sid:1805049; rev:1;
)
# 优化规则(先 content 预筛,再 pcre 精确校验)
alert http any any -> any any (
msg:"SRS cmd injection attempt (CVE-2023-34105)";
flow:to_server,established;
http.method; content:"POST"; fast_pattern:only;
http.uri.raw; content:"/api/v1/snapshots"; nocase;
http.request_body; content:"action"; fast_pattern;
http.request_body; pcre:"/action\s*=\s*[^&\r\n]*on_publish[^&\r\n]*\b(?:curl|wget|whoami|bash)\b/i";
classtype:protocol-command-decode;
priority:1;
sid:1805049; rev:2;
)
# 回放与统计
tcpreplay --intf1=eth0 --pps=500 test_traffic.pcap
suricata -r test_traffic.pcap -l /var/log/suricata
grep "SRS cmd injection" /var/log/suricata/fast.log | wc -l
pidstat -u -p $(pgrep suricata) 1 60
说明:规则文本来自原文;原文的性能数字(原始 90% 触发/8 FP/22ms/48% CPU vs 优化 100%/1 FP/14ms/17% CPU)为作者测试环境结果,未在本机复现。原文“默认缓冲区是 URI”的说法不准确:未指定粘性缓冲区时 content 匹配的是默认/上一个缓冲区,并非自动等于 URI;写规则时应显式切换缓冲区。
变体与关联
- 变体(缓冲区):
http.uri(解码)vshttp.uri.raw(原始)、http.header、http.request_body、file_data、http.response_body;不同 Suricata 版本对 sticky buffer 的支持略有差异。 - 变体(性能):
fast_pattern/fast_pattern:only、nocase、depth/offset/distance/within限制匹配范围、pcre的R/U选项。 - 变体(检测目标):命令注入、文件上传(
file_data+content:"<?php")、WebShell 响应、SQLi/XSS 关键字。 - 关联:[[defense-detection-ja3-tls-fingerprint-suricata]](Suricata 的 JA3 规则与多特征降误报);[[defense-detection-logstash-nginx-sqli-tagging]](日志侧 SQLi 检测);[[web-generic-http-smuggling-ebpf-tc-stateless-keyword-bypass]](基于关键字的检测可被绕过);[[pentest-c2-http-url-matrix-content-length-rc4-hash-loader]](HTTP 流量特征绕过)。
- 边界:加密流量、分片/重组异常、HTTP/2 多路复用、编码/压缩后的请求体会让字段级规则失效;需要结合协议解析、TLS 指纹与行为检测。
检测与防御
- 检测(规则质量):规则评审时检查“缓冲区是否在 content 前”、是否存在多个 content 共用缓冲区、是否滥用 pcre、是否把短词设为 fast_pattern、rev 是否递增;回放测试对比 FP/FN 与 CPU。
- 防御(检测体系):用 content+pcre 组合降低误报;对高价值流量做协议解析与文件提取;建立规则测试集与性能基线;对关键字检测的绕过(编码、分块、HTTP/2)补充行为/指纹检测。