从 WP Telegram Login 的 changelog.md 看 WPScan 动态版本指纹识别：ChangeLog 检测器原理与 Fixture 数据剖析

发布时间：2026/9/28 12:43:32
从 WP Telegram Login 的 changelog.md 看 WPScan 动态版本指纹识别：ChangeLog 检测器原理与 Fixture 数据剖析
网络安全漏洞扫描渗透测试应用安全CLI【免费下载链接】wpscanWPScan WordPress security scanner. Written for security professionals and blog maintainers to test the security of their WordPress websites. Contact us via contactwpscan.com项目地址https://gitcode.com/gh_mirrors/wp/wpscan点击查看免费下载WP Telegram Login 是 WordPress 生态中一款基于 Telegram 的免密登录插件其changelog.md恰好被 WPScan本项目收录为插件版本指纹的典型样例存储在 spec/fixtures/dynamic_finders/plugin_version/wptelegram-login/change_log/changelog.md 中。本文以该 fixture 为线索完整梳理 WPScan 如何利用插件自带的 Changelog 文件通过 ChangeLog底层为 BodyPattern动态查找器完成插件版本的被动/主动探测并给出 YAML 配置解析、正则写法、源码调用链与测试验证的完整脉络帮助读者既读懂这份变更日志的指纹价值也掌握 WPScan 动态指纹体系的工作原理。一、文档定位一份变更日志如何变成版本指纹在 WPScan 的动态指纹Dynamic Finders体系中插件目录中所有会随版本变化而变化、且包含版本号文本的静态文件都可以成为指纹来源。changelog.md正是最典型的一种几乎每个规范的 WordPress 插件都会维护changelog.md/CHANGELOG.md/changelog.txt最新版本的条目通常写在文件最顶部版本号以固定格式出现插件开发者通常会持续更新该文件因此其内容与当前安装版本高度同步该文件无需任何身份验证即可通过 HTTP 直接访问/wp-content/plugins/slug/changelog.md。WP Telegram Login 的这份 changelog.md 恰好满足上述全部条件因此被 WPScan 团队打包进仓库作为 ChangeLog 类动态查找器的测试样本fixture与真实指纹数据源。从该文件的内容可以看到完整的版本演进历史1.0.0 → 1.4.1其中格式的关键规律是# Changelog All notable changes to this project are documented in this file. ## [1.4.1 - 2019-03-23](https://github.com/manzoorwanijk/wptelegram-login/releases/tag/v1.4.1) ### Bug Fixes * Fixed the PHP warning on the settings page从源码结构看这类格式在大量 WordPress 插件 changelog 中通用## [x.y.z - YYYY-MM-DD]正是 WPScan 将其提炼为正则指纹的基础。二、指纹入口dynamic_finders.yml中 wptelegram-login 的完整配置WPScan 的指纹元数据集中存放在数据库目录的dynamic_finders.yml中基类中通过DB_DIR.join(dynamic_finders.yml)引用见 lib/wpscan/db/dynamic_finders/base.rb。测试环境对应的完整配置位于 spec/fixtures/db/dynamic_finders.yml。其中wptelegram-login条目共注册了三个动态查找器wptelegram-login: QueryParameter: files: - public/css/wptelegram-login-public.min.css - public/js/wptelegram-login-public.min.js version: true ChangeLog: class: BodyPattern path: changelog.md pattern: !ruby/regexp /\#\# \[(?v\d\.[\.\d]) \- [\d\-]{8,}\]/i version: true TranslationFile: class: BodyPattern path: languages/wptelegram-login.pot pattern: !ruby/regexp /Project\-Id\-Version: WP Telegram Login (?v\d\.[\.\d])/i version: true对 ChangeLog 条目逐字段拆解配置键取值本插件含义与实现位置classBodyPattern动态查找器的实际实现类ChangeLog 只是逻辑别名。类在 lib/wpscan/finders/dynamic_finder/wp_item_version.rb 中被映射为Finders::DynamicFinder::Version::BodyPatternpathchangelog.md相对于插件根目录的静态文件路径存在path时查找器只能以**主动aggressive**方式运行见 lib/wpscan/finders/dynamic_finder/finder.rb 中passive/aggressive的分支判断pattern/\#\# \[(?v\d\.[\.\d]) \- [\d\-]{8,}\]/i用于从响应体提取版本号的正则命名捕获组(?v...)是版本号出口versiontrue该查找器被归类为版本查找器会被Plugin.versions_finders_configs收集见 lib/wpscan/db/dynamic_finders/plugin.rb值得注意ChangeLog本身并不在Base.allowed_classeslib/wpscan/db/dynamic_finders/base.rb 中允许的是Comment、Xpath、HeaderPattern、BodyPattern、JavascriptVar、QueryParameter、ConfigParser中它是通过class: BodyPattern间接映射到合法实现类的。这也是为什么Plugin.create_versions_finders在创建类时使用config[class] || finder_name取值lib/wpscan/db/dynamic_finders/plugin.rb。2.1 正则逐字符解读针对 WP Telegram Login 的版本条目格式## [1.4.1 - 2019-03-23]指纹正则为/\#\# \[(?v\d\.[\.\d]) \- [\d\-]{8,}\]/i\#\#匹配 Markdown 的二级标题##\[匹配左方括号(?v\d\.[\.\d])命名捕获组v匹配版本号要求至少一个数字后跟点号再匹配点号数字序列可容纳1.4.1、1.0.1、0.9.97.44等多段位版本\-匹配带空格包围的连字符对应-[\d\-]{8,}匹配至少 8 个字符的日期区间形态如2019-03-23恰好 10 个字符\]匹配右方括号i忽略大小写兼容各种风格的 Markdown 变更日志。对照 changelog.md 实际内容## [1.4.1 - 2019-03-23]行可被完整命中并捕获1.4.1。2.2 与其他指纹的配合同一条目还注册了QueryParameter被动、解析?ver查询参数见 lib/wpscan/finders/dynamic_finder/wp_item_version.rb 的path_pattern与xpath实现和TranslationFile同样以 BodyPattern 从.pot文件中提取Project-Id-Version: WP Telegram Login 1.4.1。三个查找器互为印证ChangeLog 与 TranslationFile 在主动扫描时确认版本QueryParameter 在被动扫描首页时即可低成本发现版本。三、源码级实现ChangeLog 如何被解析与匹配3.1 配置加载与类生成WPScan::DB::DynamicFinders::Plugin负责把 YAML 配置转化为可运行的查找器类df_data读取dynamic_finders.yml中的plugins段lib/wpscan/db/dynamic_finders/plugin.rbversions_finders_configs过滤出所有带version: true的配置lib/wpscan/db/dynamic_finders/plugin.rbcreate_versions_finders(slug)为wptelegram-login这样的 slug 建立Finders::PluginVersion::WptelegramLogin模块并用version_finder_super_class(BodyPattern)定位到WPScan::Finders::DynamicFinder::WpItemVersion::BodyPattern最终调用create_child_class生成子类lib/wpscan/db/dynamic_finders/plugin.rbcreate_child_class将配置中的path、pattern、confidence等键映射为子类常量PATH、PATTERN、CONFIDENCElib/wpscan/finders/dynamic_finder/finder.rb。由于ChangeLog条目的path非空该查找器只会走主动路径不会在被动模式下被误用。3.2 BodyPattern 的匹配逻辑ChangeLog 实际执行的是 BodyPattern 查找器lib/wpscan/finders/dynamic_finder/version/body_pattern.rbdef 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关键行为非 404 且响应体命中PATTERN时才继续版本号取自命名捕获组Regexp.last_match[:v]将请求的 URL 命中的匹配文本记录为interesting_entries供输出报告展示取证细节默认置信度为 60CONFIDENCE: 60见 lib/wpscan/finders/dynamic_finder/version/body_pattern.rb如配置中显式给出confidence则覆盖默认值。配合aggressive方法lib/wpscan/finders/dynamic_finder/finder.rb主动扫描时会直接请求target.url(changelog.md)——即https://site/wp-content/plugins/wptelegram-login/changelog.md再把响应交给find。3.3 版本对象的构造命中后create_version会构建Model::Version并把found_by如 Change Log (Aggressive Detection)与置信度写入 finding 元数据lib/wpscan/finders/dynamic_finder/version/finder.rb。最终版本会与其他查找器QueryParameter、TranslationFile 等的结果汇聚由上层 lib/wpscan/finders/finder.rb 与 lib/wpscan/finders/findings.rb 统一管理去重与合并。四、测试证据Fixture 与期望结果4.1 期望输出expected.yml在 spec/fixtures/dynamic_finders/expected.yml 的wptelegram-login段中记录了针对本仓库 fixture 数据的预期探测结果wptelegram-login: QueryParameter: number: 1.2.0 found_by: Query Parameter (Passive Detection) interesting_entries: - http://wp.lab/wp-content/plugins/wptelegram-login/public/css/wptelegram-login-public.min.css?ver1.2.0 - http://wp.lab/wp-content/plugins/wptelegram-login/public/js/wptelegram-login-public.min.js?ver1.2.0 confidence: 20 ChangeLog: number: 1.4.1 found_by: Change Log (Aggressive Detection) interesting_entries: - http://wp.lab/wp-content/plugins/wptelegram-login/changelog.md, Match: ## [1.4.1 - 2019-03-23] TranslationFile: number: 1.4.1 found_by: Translation File (Aggressive Detection) interesting_entries: - http://wp.lab/wp-content/plugins/wptelegram-login/languages/wptelegram-login.pot, Match: Project-Id-Version: WP Telegram Login 1.4.1解读要点ChangeLog 检测命中1.4.1匹配文本正是## [1.4.1 - 2019-03-23]与 changelog.md 首行版本条目完全对应TranslationFile 同样命中1.4.1来自同目录下的 translation_file/languages/wptelegram-login.pot二者交叉验证了版本一致性QueryParameter 仅命中1.2.0且置信度 20——说明被动探测受限于前端静态资源所携带的?ver参数与插件当前实际版本可能存在时差这是该检测路径的固有局限所有found_by命名遵循查找器名称 (Passive/Aggressive Detection)规范直接进入报告输出对应 app/views/cli/enumeration/plugin.erb 等视图层。4.2 单元测试BodyPattern 的 PATH 与 PATTERN 行为spec/lib/finders/dynamic_finder/version/body_pattern_spec.rb 验证了子类生成时的常量注入规则未配置path时PATH默认为nil被动模式可用配置path: changelog.txt后PATH被注入主动模式专用PATTERN取自配置CONFIDENCE默认 60可被confidence覆盖。这套测试确认了 ChangeLog 类查找器无 path 走被动、有 path 走主动的设计约束而 WP Telegram Login 的 changelog.md 指纹正是带path的主动检测典型用例。五、实战视角从 changelog 指纹到一次完整扫描结合上述源码与配置可以还原针对安装有 wptelegram-login 的目标站点的版本探测流程被动阶段扫描器抓取首页与 404 页响应QueryParameter查找器从wptelegram-login-public.min.css?ver...、wptelegram-login-public.min.js?ver...中提取1.2.0置信度 20主动阶段--plugins-detection aggressiveChangeLog查找器请求.../wptelegram-login/changelog.md用## \[(?v\d\.[\.\d]) - [\d\-]{8,}\]命中1.4.1TranslationFile查找器请求.../languages/wptelegram-login.pot命中同版本1.4.1结果合并两个高置信度60结果互相印证最终判定插件版本为 1.4.1并在报告中以Change Log (Aggressive Detection)与Translation File (Aggressive Detection)标注来源。六、局限与注意事项版本滞后风险插件开发者可能忘记更新 changelog 顶部条目或版本条目格式与正则不符如缺少日期、使用包裹的 WordPress 标准风格此时 BodyPattern 匹配会落空需要依赖风格或补充正则变体见同 fixture 目录下 2fas 等插件使用的 2.4.1风格 changelog.txt 对比主动探测的可观测性带path的查找器会向目标发起额外 HTTP 请求可能被目标站点日志记录这是主动检测的固有取舍被动探测置信度低?ver参数反映的是静态资源打包时的版本不总是等于插件当前版本WPScan 通过低置信度20与多源交叉来规避误报Fixture 数据仅代表样本时刻本仓库的 changelog.md 与 expected.yml 记录的是 2019-03-23v1.4.1时的指纹状态实际扫描中插件版本由目标站点决定。七、小结通过 WP Telegram Login 的这份 changelog.md 样例可以完整串联起 WPScan 动态指纹体系的一条主线插件自带的变更日志文件 →dynamic_finders.yml中的ChangeLogBodyPattern配置 → 正则命名捕获组提取版本 → 主动 HTTP 请求 非 404 校验 → 版本对象与取证条目产出 → expected.yml 测试基准回归。理解这条链路就能理解 WPScan 为何能对成千上万个插件做到零数据库条目也能识别版本——答案就藏在每个插件都携带的 changelog 与翻译文件里。赞分享网络安全漏洞扫描渗透测试应用安全CLI【免费下载链接】wpscanWPScan WordPress security scanner. Written for security professionals and blog maintainers to test the security of their WordPress websites. Contact us via contactwpscan.com项目地址https://gitcode.com/gh_mirrors/wp/wpscan点击查看免费下载相关推荐WPScan 插件版本指纹识别intergeo-maps CHANGELOG.md 动态检测原理解析WPScan 插件版本指纹识别intergeo maps CHANGELOG.md 动态检测原理解析 WPScan 是面向安全专业人员与博客维护者的 Word网络安全漏洞扫描渗透测试应用安全CLIWPScan 动态指纹识别实战以 wp-flexible-map 的 ChangeLog 指纹changelog.md为例WPScan 动态指纹识别实战以 wp flexible map 的 ChangeLog 指纹changelog.md为例 导读 本篇文章以 WPSca网络安全漏洞扫描渗透测试应用安全CLI从 changelog.md 指纹识别插件版本WPScan 动态指纹 ChangeLog 探测机制深度解析从 changelog.md 指纹识别插件版本WPScan 动态指纹 ChangeLog 探测机制深度解析 导读 本文聚焦 WPScan 动态指纹Dynam网络安全漏洞扫描渗透测试应用安全CLI上一篇NewLife.Cube快速上手dotnet new cube一条命令生成项目快速开始教程下一篇Iconify图标列表管理添加、删除与批量操作的完整实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考