从 CHANGELOG 指纹识别插件版本:解析 WPScan 动态查找器(Dynamic Finder)的 ChangeLog BodyPattern 机制

原创2026-09-24 15:02:201,927 阅读
文章标签:网络安全渗透测试漏洞扫描应用安全CLI

从 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 的两个数据体系中:

  1. 测试数据(fixture):spec/fixtures/dynamic_finders/plugin_version/fathom-analytics/change_log/CHANGELOG.md,供 spec 测试验证动态查找器能否从该格式的 changelog 中正确提取版本;
  2. 真实指纹库: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

关键点:

  1. 响应过滤:仅当 HTTP 状态码不是 404 时才继续,404 表示目标站点上不存在该 changelog 文件;
  2. 正则匹配:将响应正文与该查找器类内定义的 PATTERN 正则做匹配(该 PATTERN 正是由 YAML 中的 pattern 字段注入的);
  3. 版本提取:通过 Regexp.last_match[:v] 取出具名捕获组 v 中的版本号,即 YAML 正则中 (?<v>...) 的内容;
  4. 证据记录:将请求 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 插件版本指纹体系中"文件抓取 + 正则提取"这一核心范式的完整闭环。

登录后查看全文
wpscan