vaycore/OneScan

OneScan 是一款用于递归目录扫描的 BurpSuite 插件

OneScan

OneScan是递归目录扫描的BurpSuite插件。

插件介绍

OneScan插件的思路由One哥提供，我负责将One哥的思路进行编码变现。插件起初是为了发现站点的 Swagger-API 文档页面，例如有些站点将 Swagger-API 文档存放在当前API接口同路由下（或者更深层次目录），使用OneScan插件可以快速发现这类页面和接口

参与开发人员：

• 主要开发: vaycore
• 后续更新功能: Rural.Dog
• 产品经理: 0ne_1

简单示例

例如配置Payload字典如下：

/api-docs
/{{domain.name}}.zip

目标站点访问：https://www.xxxxxx.com/a/b/c/xxx.min.js ，插件会自动扫描如下的路径：

https://www.xxxxxx.com/api-docs
https://www.xxxxxx.com/xxxxxx.zip
https://www.xxxxxx.com/a/api-docs
https://www.xxxxxx.com/a/xxxxxx.zip
https://www.xxxxxx.com/a/b/api-docs
https://www.xxxxxx.com/a/b/xxxxxx.zip
https://www.xxxxxx.com/a/b/c/api-docs
https://www.xxxxxx.com/a/b/c/xxxxxx.zip

插件安装

BurpSuite 安装流程如下（不同版本可能有所差异）：

Extender -> Extensions -> Add -> Select File -> Next
Extensions -> Installed -> Add -> Select File -> Next

流程结束后，打印如下信息表示插件安装完成（需要在 Config -> Other -> HaE 中配置 HaE 插件 JAR 包路径后，才会显示 HaE 插件的日志信息、数据高亮功能）：

插件配置文件默认存放路径如下（优先检测当前插件 jar 包所在目录下是否存在 OneScan 目录，如果存在，将使用该目录作为工作目录；否则，使用如下路径作为工作目录）：

linux、macOS：
~/.config/OneScan/

windows：
C:\Users\<用户名>\.config\OneScan\

插件说明

主动扫描

可以从BurpSuite其它位置发送到OneScan主动扫描

可以使用已配置的字典发送到OneScan主动扫描（存在1个以上的字典配置才会出现该菜单）：

辅助面板

提取请求和响应包中JSON格式的字段，插件1.0.0版本新增Fingerprint指纹信息展示

动态变量

目前支持的动态变量如下（以目标：http://www.xxxxxx.com:81/path/to/index.html 为例，日期和时间以：2030-08-09 07:08:09 为例）：

{{host}} - 请求头中的Host（格式：www.xxxxxx.com:81）
{{domain}} - 请求头中不包含端口号的Host（格式：www.xxxxxx.com）
{{domain.main}} - 主域名（格式：xxxxxx.com；如果是IP地址或无效格式，会自动跳过这条Payload）
{{domain.name}} - 主域名的名称（格式：xxxxxx；如果是IP地址或无效格式，会自动跳过这条Payload）
{{protocol}} - 请求头中的协议（格式：http）
{{timestamp}} - Unix时间戳（单位：秒）
{{random.ip}} - 随机IPv4值
{{random.local-ip}} - 随机内网IPv4值
{{random.ua}} - 随机UserAgent值，随机源可配置
{{subdomain}} - 子域名动态变量（格式：www；只有主域名时：`xxxxxx.com` => `xxxxxx`）
{{webroot}} - 一级目录动态变量（格式：path；不存在一级目录时，会自动跳过这条Payload）
{{date.yyyy}} - 日期：年（格式：2030）
{{date.MM}} - 日期：月（格式：08）
{{date.dd}} - 日期：日（格式：09）
{{date.yy}} - 日期：年（格式：30）
{{date.M}} - 日期：月（格式：8）
{{date.d}} - 日期：日（格式：9）
{{time.HH}} - 时间：小时（格式：07）
{{time.mm}} - 时间：分钟（格式：08）
{{time.ss}} - 时间：秒（格式：09）
{{time.H}} - 时间：小时（格式：7）
{{time.m}} - 时间：分钟（格式：8）
{{time.s}} - 时间：秒（格式：9）

Databoard数据看板

插件数据看板说明如下

• Listen Proxy Message 开关被动扫描（默认禁用），代理的请求包都会经过OneScan（建议配置白名单后启用）
• Exclude Header 开关排除请求头（默认禁用），根据 Request -> Exclude header 里的配置，排除请求头中对应的值
• Replace Header 开关请求头替换（默认启用），使用 Request -> Header 中配置的请求头请求数据
• DirScan 开关递归扫描（默认启用），对目标进行递归扫描
• Payload Processing 开关 Payload Processing 功能（默认启用）
• Filter 设置数据过滤规则
• Import url 导入 Url 目标进行扫描
• Stop 停止正在扫描的任务
• Clear 清空所有记录（与菜单项 “清空所有记录” 功能一致，同时也会清空临时过滤规则）

过滤规则配置

点击主面板的Filter按钮，打开设置过滤规则对话框（插件0.5.2版本新增功能）

• Select column 选择要过滤的列
• Add filter 为选中列添加过滤条件
• Clear 清除选中列的所有过滤规则
• Reset 重置所有过滤规则
• Cancel 取消本次的所有变更
• OK 使配置的规则生效

临时过滤规则

通过右键菜单，点击“临时过滤选中数据”添加临时过滤规则：

只支持临时添加相同值的过滤（复杂的规则，请点击 Filter 按钮处理），例如选中了 Status 是 400 和 503 的两条数据，生成的临时过滤规则示例如下：

Status != 400 && Status != 503

注： 在 “清空所有记录” 后，同时也会 “清空临时过滤规则”

Config配置

Payload（字典、Payload处理）

Payload配置界面如下

• Payload 配置递归扫描的字典
• Payload Processing 配置请求过程中对数据包的处理（例如：URL添加前缀、后缀，Body正则匹配和替换）

Request（请求相关配置）

Request配置界面如下

• QPS QPS限制，限制每秒请求的数量，范围（1-9999）
• Request delay 请求延时限制，限制每次请求的间隔时间，范围（0-99999）。（单位：毫秒）
• Scan level 限制目录扫描层级，范围（1-99）。限制方向：Left to right（从左往右），Right to left（从右往左）
• Retry 请求失败时重试次数配置，范围（0-9）
• Include method 配置请求方法白名单
• Exclude suffix 排除指定后缀的数据包
• Header 递归扫描过程的请求头配置，可配置变量
• Exclude header 请求时排除请求头中对应的值
• UserAgent 这里配置的是 {{random.ua}} 变量列表里的值

Host（主要是黑、白名单配置）

Host配置界面如下

• Host Whitelist 配置白名单列表，如果该列表不为空，插件则只能请求该列表中的Host
• Host Blacklist 配置黑名单列表，插件不对该列表配置的Host进行请求

Other（其它配置）

Other配置界面如下

• Maximum display length 限制请求、响应包的最大显示长度（插件 1.6.11 版本新增）
• Collect directory 数据收集存放目录
• Wordlist Directory 插件1.0.0版本新增字典管理，此目录下包含所有字典文件的配置
• HaE 配置与 HaE 插件联动，实现主面板数据高亮（配置路径示例如图）
• Clear Temp 清除指纹识别缓存（用于加快指纹识别的速度）

Fingerprint指纹

插件1.0.0版本新增Fingerprint指纹模块，指纹管理界面如下

• Reload 重新加载配置文件中的指纹信息
• Search 搜索指纹库中的指纹信息
• Add 添加指纹信息
• Edit 编辑选中的指纹信息
• Delete 删除选中的指纹信息
• Test 测试指纹规则

指纹信息全程使用UI添加，不需要编写正则匹配规则（也可以使用正则匹配），UI界面如下：

指纹信息说明

• Name 指纹名称（产品名）
• Company 产品公司（默认：Other）
• Lang 编程语言
• SoftHard 软硬件（0=其它；1=硬件；2=软件）
• Frame 产品使用的开发框架
• ParentCategory 父类别（默认：Other）
• Category 类别（默认：Other）
• Rules 指纹匹配规则

指纹规则说明

包含七种数据源

• header Header
• server Header 中的 Server 值
• body Body 数据
• title Html 标题
• bodyMd5 Body 数据 MD5 值
• bodyHash Body 数据 Hash 值
• banner 其它协议的 Banner 信息（HTTP协议无法匹配该值）

共有十种匹配方法

• equals 匹配相等
• notEquals 匹配不相等
• iEquals 匹配相等（忽略大小写）
• iNotEquals 匹配不相等（忽略大小写）
• contains 包含
• notContains 不包含
• iContains 包含（忽略大小写）
• iNotContains 不包含（忽略大小写）
• regex 正则匹配
• notRegex 正则不匹配

Collect数据收集

插件 1.5.0 版本新增 Collect 数据收集面板，面板截图如下：

• All 列出所有收集的数据
• JsonField 收集的 JSON 字段信息
• WebName 收集的 WebName 信息（例如访问：/api/v1/users，会自动收集 api）
• Search 在列表中搜索对应数据（正则表达式）
• Reverse 反向搜索（勾选后，例如搜索：a，列表中不会出现包含 a 的数据）
• Ignore Case 忽略大小写

插件演示

将如下数据包主动发送到OneScan：

POST /mcp/pc/pcsearch HTTP/1.1
Host: ug.baidu.com
Content-Length: 56
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36
Content-Type: application/json
Accept: */*
Origin: https://www.baidu.com
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,zh;q=0.9
Connection: close

{"invoke_info":{"pos_1":[{}],"pos_2":[{}],"pos_3":[{}]}}

面板展示如下：

QQ交流群

欢迎各位师傅加入 OneScan 交流群

项目热度

非常感谢各位师傅关注此项目

END

• 代码写的很乱，还请师傅们见谅
• 欢迎各位师傅提交 Issue 和 Pull requests，一起完善项目