♧ Godown 安全知识树

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 与性能指标。

利用步骤

  1. 明确要检测的协议字段:方法、URI(解码/原始)、请求头、请求体、文件内容、响应体;为每个字段选择对应的粘性缓冲区关键字。
  2. 按“先缓冲区、后匹配”的顺序写规则:每个 content/pcre 前都确保当前缓冲区正确;需要切换时重新写缓冲区关键字。
  3. 用 content 选一个稳定、较长的核心子串做预筛;在其后写 pcre 做精确校验(注意转义、大小写与边界)。
  4. 在核心 content 上加 fast_pattern(或 fast_pattern:only),避免把短词/通用词设为快速模式。
  5. 用 suricata -r test.pcap -l /var/log/suricata 回放,检查 fast.log/eve.json 是否命中预期流量、是否误报正常流量。
  6. 用 tcpreplay/wrk 做压力测试,记录触发率、FP/FN、延迟、CPU、内存;修改规则后递增 rev。
  7. 把规则纳入评审清单:缓冲区顺序、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(解码)vs http.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)补充行为/指纹检测。