从 CHANGELOG 指纹识别插件版本:解析 WPScan 动态查找器(Dynamic Finder)的 ChangeLog BodyPattern 机制
从 CHANGELOG 指纹识别插件版本:解析 WPScan 动态查找器(Dynamic Finder)的 ChangeLog BodyPattern 机制
WPScan 作为 WordPress 安全扫描器,其插件版本识别依赖一套名为"动态查找器(Dynamic Finder)"的自动化机制。本文以仓库中 fathom-analytics 插件的 CHANGELOG 指纹数据 为切入点,深入解析"基于 ChangeLog 文件的正则版本提取"这一动态查找器的工作原理、配置数据格式与源码实现,帮助你掌握 WPScan 插件版本指纹的构建与解析全流程。
一、什么是动态查找器(Dynamic Finder)
动态查找器是 WPScan 用于识别 WordPress 插件、主题与核心版本的一类自动化查找器。它的核心思想是:将"如何从目标站点响应中提取版本号"的规则外部化为配置文件(dynamic_finders.yml),工具启动后按规则动态生成对应的查找器类,而无需为每个插件硬编码版本探测逻辑。
在 WPScan 的源码结构中,动态查找器分为两个层面:
- 配置层:
lib/wpscan/db/dynamic_finders/目录下的base.rb、plugin.rb、theme.rb、wordpress.rb,负责读取 YAML 配置并按 slug(插件/主题的目录名)生成查找器类; - 执行层:
lib/wpscan/finders/dynamic_finder/目录下按提取方式划分的查找器实现,包括body_pattern.rb、comment.rb、header_pattern.rb、xpath.rb、javascript_var.rb、query_parameter.rb、config_parser.rb等。
其中,本篇文章聚焦的 ChangeLog 查找器,在配置中表现为 class: BodyPattern 与 path: CHANGELOG.md 的组合,属于"抓取插件目录下的 CHANGELOG 文件、用正则提取版本号"这一类。
二、关联文档:fathom-analytics 的 CHANGELOG.md
仓库中 fathom-analytics 插件的 CHANGELOG.md 是一个用于测试动态查找器解析能力的固定样例(fixture),其内容如下:
Changelog
==========
#### 1.0.1 - October 10, 2018
Added support for tracking multiple sites in a single Fathom dashboard (requires Fathom v1.0.1).
#### 1.0.0 - September 10, 2018
Plugin release.
这份文件同时出现在 WPScan 的两个数据体系中:
- 测试数据(fixture):
spec/fixtures/dynamic_finders/plugin_version/fathom-analytics/change_log/CHANGELOG.md,供 spec 测试验证动态查找器能否从该格式的 changelog 中正确提取版本; - 真实指纹库:
spec/fixtures/db/dynamic_finders.yml中fathom-analytics条目对应的ChangeLog配置,定义了提取该文件版本号的完整规则。
它的结构特征非常典型:以 #### 1.0.1 - October 10, 2018 这类"版本号 + 发布日期"行作为版本标记。WPScan 正是针对这一行文格式设计正则的。
三、指纹配置解析:从 dynamic_finders.yml 看 ChangeLog 条目
在 dynamic_finders.yml(第 48480 行附近)中,fathom-analytics 的配置如下:
fathom-analytics:
ChangeLog:
class: BodyPattern
path: CHANGELOG.md
pattern: !ruby/regexp /^\#\#\#\# (?<v>\d+\.[\.\d]+) \- [^\r\n]+$/i
version: true
逐字段解读:
| 配置字段 | 值 | 含义 |
|---|---|---|
ChangeLog |
映射键 | 查找器名称,说明这是一个基于 changelog 的版本查找器 |
class |
BodyPattern |
指定实际使用的查找器实现类(见 body_pattern.rb) |
path |
CHANGELOG.md |
在目标站点插件目录下要请求的相对文件路径,即 <plugins_dir>/fathom-analytics/CHANGELOG.md |
pattern |
Ruby 正则 | 用于从文件正文中提取版本号的匹配规则 |
version |
true |
标记该查找器用于版本探测(而非仅用于插件存在性判断) |
需要说明的是,该配置存放在 spec/fixtures/db/dynamic_finders.yml 中,属于测试夹具版本的指纹库;WPScan 运行时使用的真实数据库由 DB::DynamicFinders::Base#df_file 指向 DB_DIR/dynamic_finders.yml(可通过 wpscan --update 更新),两者结构与字段完全一致。
正则逐段剖析
核心正则 ^\#\#\#\# (?<v>\d+\.[\.\d]+) \- [^\r\n]+$/i 与 CHANGELOG.md 中 #### 1.0.1 - October 10, 2018 的对应关系:
| 正则片段 | 匹配内容 |
|---|---|
^\#\#\#\# |
行首四个 # 加一个空格(对应 Markdown 四级标题 #### ),# 需转义为 \# |
(?<v>\d+\.[\.\d]+) |
具名捕获组 v,捕获版本号。\d+ 匹配主版本(如 1),\.[\.\d]+ 匹配 .0.1 这类点号后接数字(含重复的 .数字 片段),可支持 1.0.1、1.2.3.4 等多段版本 |
\- |
一个反斜杠转义的短横线加两侧空格,对应日期分隔符 - |
[^\r\n]+ |
匹配到行尾的任意非换行字符(如 October 10, 2018) |
$ |
行尾锚点;配合 i 标志对字母不区分大小写 |
该模式仅匹配"版本号 + 日期"的标题行,从而避免把 changelog 正文中的零散数字误判为版本。这个正则同样被用于 fatturegratis-free-fattura-elettronica、faustwp 等插件的 ChangeLog 条目(见 dynamic_finders.yml 中相关配置),是一套被复用的通用 changelog 版本提取规则。
四、源码级原理:ChangeLog 查找器如何运行
4.1 配置加载与类生成
DB::DynamicFinders::Plugin 负责插件维度的动态查找器管理:
df_data从指纹库读取plugins段数据;finder_configs(finder_class, aggressive: false)按查找器类型与攻击模式筛选配置。其中aggressive为true时保留带path的配置(需要主动请求具体文件),false时仅保留不带path的被动配置;create_versions_finders(slug)为指定 slug 动态创建版本查找器类。它通过maybe_create_module将 slug(如fathom-analytics)归类为常量名,再依据配置中的class字段(如BodyPattern)从WPScan::Finders::DynamicFinder::WpItemVersion::*中选取父类创建子类。
由于 ChangeLog 条目声明了 path,它属于主动(aggressive)模式的查找器:扫描器会主动请求 wp-content/plugins/fathom-analytics/CHANGELOG.md 来获取文件内容。
4.2 BodyPattern 的版本提取逻辑
Finders::DynamicFinder::Version::BodyPattern 是实际执行版本提取的类,其 find 方法逻辑非常精简:
def find(response, _opts = {})
return unless response.code != 404 && response.body =~ self.class::PATTERN
create_version(
Regexp.last_match[:v],
interesting_entries: ["#{response.effective_url}, Match: '#{Regexp.last_match}'"]
)
end
关键点:
- 响应过滤:仅当 HTTP 状态码不是 404 时才继续,404 表示目标站点上不存在该 changelog 文件;
- 正则匹配:将响应正文与该查找器类内定义的
PATTERN正则做匹配(该PATTERN正是由 YAML 中的pattern字段注入的); - 版本提取:通过
Regexp.last_match[:v]取出具名捕获组v中的版本号,即 YAML 正则中(?<v>...)的内容; - 证据记录:将请求 URL 与完整匹配结果记录为
interesting_entries,作为该版本判定的佐证信息。
child_class_constants 中还定义了 PATTERN: nil, CONFIDENCE: 60,即 BodyPattern 类查找器的默认置信度为 60。版本号提取成功后,WPScan 会结合多个查找器的结果与置信度综合判定最终版本。
4.3 与 Readme 查找器的区别
在 dynamic_finders.yml 中可以看到,大多数插件使用 Readme 条目(path: readme.txt)来探测版本,而 fathom-analytics 这类插件则同时或单独使用 ChangeLog 条目。二者的差异在于:
- Readme 查找器依赖 WordPress 插件标准 readme.txt 中的
Stable tag:行; - ChangeLog 查找器依赖插件作者维护的 CHANGELOG/CHANGELOG.md 文件中的版本标题行。
部分插件(如 fatturegratis-free-fattura-elettronica)同时配置了 Readme 与 ChangeLog 两个条目,说明 WPScan 会为同一插件注册多条版本探测路径,互为补充、提高识别成功率。
五、如何在 WPScan 中使用
5.1 更新指纹库
运行时指纹库(含所有插件的 ChangeLog 等动态查找器配置)可通过以下命令更新:
ruby wpscan.rb --update
更新后的 dynamic_finders.yml 存放在 WPScan 的数据库目录(DB_DIR)中,具体路径由 DB::DynamicFinders::Base 定义。
5.2 触发插件版本扫描
对目标站点执行插件枚举时,主动模式查找器会自动请求各插件的 CHANGELOG.md 并尝试提取版本:
ruby wpscan.rb --url https://example.com --enumerate vp
vp 表示"只枚举有漏洞的插件(vulnerable plugins)";若要枚举全部插件可改用 --enumerate p。扫描过程中,BodyPattern 查找器会针对指纹库中存在 ChangeLog 配置的插件 slug,逐一请求其 CHANGELOG.md 路径并按正则匹配版本。
5.3 测试与验证
仓库在 spec/fixtures/dynamic_finders/plugin_version/ 下按 slug/查找器名/ 组织固定样例,fathom-analytics/change_log/CHANGELOG.md 即用于验证"BodyPattern + ChangeLog"组合的解析正确性。如果你希望验证某个新格式的 changelog 能否被识别,可以对照 dynamic_finders.yml 中 fathom-analytics 条目的正则写法,构造等价样例并运行对应 spec。
六、小结
- WPScan 的插件版本识别并非为每个插件硬编码逻辑,而是通过
dynamic_finders.yml中的规则化配置动态生成查找器; - ChangeLog 指纹是其中重要的一类:以
class: BodyPattern + path: CHANGELOG.md + pattern 正则 + version: true描述"抓取 changelog 文件、用正则提取版本号"的完整流程; - 正则通过
(?<v>...)具名捕获组直接产出版本号,由 BodyPattern#find 消费,并结合默认置信度 60 参与最终版本判定; - 这类查找器属于主动(aggressive)模式,扫描时会真实请求目标站点的 changelog 文件,因此要求插件目录中实际存在对应文件才能生效。
掌握 ChangeLog 动态查找器的配置与执行原理,你就理解了 WPScan 插件版本指纹体系中"文件抓取 + 正则提取"这一核心范式的完整闭环。