# BurpInjector

**Repository Path**: wangbing69/BurpInjector

## Basic Information

- **Project Name**: BurpInjector
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-04
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Injector - Path Collector

`Injector - Path Collector` 是一款 Burp Suite 插件，旨在解决传统 SQL 注入扫描器的检测盲区——即无法有效识别 **URL 路径片段** 及 **隐藏 XFF 请求头** 中潜在的注入漏洞。该插件能够自动甄别非静态接口，对 URL 路径各层级及特定 HTTP 头部进行自动化 Fuzz 测试；同时兼具路径采集功能，自动收集并泛化目标站点接口，帮助安全研究人员快速梳理资产清单。

## 🚀 主要功能

* **路径字典自动收集**：实时记录经过 Burp 的唯一接口路径。支持切换 **Host+Path** 或 **单 Path** 显示模式，方便直接导出为扫描字典。
* **自动化路径注入**：自动拆解 URL 路径层级，在每个路径片段后尝试注入测试 Payload（如 `'`, `''`）。
* **智能路径跳过 (Smart Path Skip)**：若 `/api/v1/` 已被验证为安全，后续请求（如 `/api/v1/user`）将自动跳过对 `api` 和 `v1` 片段的重复测试，极大提升扫描效率。
* **静态过滤**：自动识别并跳过末尾带有 `.`（文件后缀）的资源请求，确保扫描仅聚焦于无后缀的 API 业务接口。
* **路径泛化去重**：内置智能识别逻辑，自动将路径中的数字（日期、ID）及长哈希（UUID）泛化为 `{num}` 或 `{id}` 占位符，避免对相似路径进行冗余扫描。
* **错误特征匹配**：内置主流数据库（MySQL, Oracle, SQL Server, PostgreSQL, SQLite）的报错监控，发现异常自动预警。
* **可视化反馈**：
    * 发现 SQL 错误时，左侧任务列表将整行**标记为红色**。
    * 实时显示响应包长度变化（Diff）、HTTP 状态码及请求耗时。
 
<img width="2537" height="1392" alt="image" src="https://github.com/user-attachments/assets/87256ede-9aba-49dd-baa0-f2fa9750fc46" />


## 🛠️ 安装方法

1.  确保已在 Burp Suite 中配置好 **Jython** 环境（插件基于 Python 2.7 开发）。
2.  下载本仓库的 `Injector.py`。
3.  打开 Burp Suite -> `Extensions` -> `Installed` -> `Add`。
4.  `Extension type` 选择 **Python**，并选择 `Injector.py` 文件。
5.  在 Burp 工具栏中看到 `Injector` 标签页即表示安装成功。

## 📖 使用指南

### 1. 查看结果
* **左侧表格**：显示主扫描任务。红色背景表示该路径触发了数据库报错。
* **右侧表格**：点击左侧任务，右侧将详细列出该路径下所有注入点（Path_N 层级或 Header）的具体测试响应。

### 2. 配置说明
| 配置项 | 说明 | 推荐设置 |
| :--- | :--- | :--- |
| **Domain Whitelist** | 支持 **Regex Search** 模式，匹配目标域名。 | `.*\.target\.com` |
| **Block Status Codes** | 过滤掉不需要测试的状态码，减少干扰。 | `301, 404, 502等` |
| **Strict Whitelist** | 开启后仅扫描白名单内的 Host。 | 默认：关闭 |
| **Show Host in Dictionary** | 路径字典是否显示 Host 前缀。 | 根据导出需求切换 |


## 🔍 技术特性

* **全量检测点**：覆盖 URL 路径各层级及 `X-Forwarded-For`, `X-Real-IP`, `Client-IP` 等常见头部字段。
* **多线程架构**：采用异步处理机制，确保在大批量扫描时不会卡顿 Burp 主界面。
* **精确去重**：基于 `Method + Host + Generalized Path` 计算 MD5 校验，确保每个逻辑接口仅被扫描一次。

## ⚠️ 免责声明

本工具仅用于授权环境下的安全研究与渗透测试。使用者在使用本工具进行测试时，应遵守当地法律法规。对于因滥用本工具导致的任何法律后果，作者不承担任何责任。