Recheck Scan API Extension là một extension dành cho Burp Suite Professional giúp theo dõi và quản lý trạng thái quét các API endpoints. Extension này tự động phát hiện, lưu trữ và theo dõi các tham số của API, đồng thời cung cấp giao diện trực quan để quản lý trạng thái quét.
- Tự động phát hiện và ghi nhận các API endpoints từ HTTP traffic
- Trích xuất tham số từ URL query string và request body
- Hỗ trợ các định dạng: JSON, XML, URL-encoded, Multipart
- Scanned: Tham số đã được Burp Scanner quét
- Rejected: API bị từ chối không quét (do người dùng đánh dấu)
- Bypassed: API được tự động bỏ qua (không có tham số)
- Repeater: API đã được gửi qua Burp Repeater
- Tab Unscanned: Chỉ hiển thị API chưa được xử lý
- Tab Logs: Hiển thị tất cả API đã ghi nhận
- Tìm kiếm real-time theo đường dẫn API
- Sắp xếp và lọc theo nhiều tiêu chí
- Loại trừ file extension không cần thiết
- Loại trừ status code cụ thể
- Tự động highlight/note trong Proxy history
- Tự động bypass API không có tham số
- Burp Suite Professional 2023.1.2+
- Java Runtime Environment 17+
- SQLite JDBC Driver (đã tích hợp)
-
Build project:
# Clone repository git clone https://github.com/vn-ncvinh/RecheckScan.git cd RecheckScan # Build với Maven mvn clean package
-
Load extension vào Burp:
- Mở Burp Suite Professional
- Vào tab
Extensions→Installed - Click
Add→Java - Chọn file jar phù hợp (xem bảng dưới)
File Dùng cho Dung lượng target/RecheckScan.jarMọi nền tảng Burp thông dụng — chọn cái này nếu không chắc ~3.7 MB target/RecheckScan-win-x64.jarWindows x86_64 ~0.8 MB target/RecheckScan-linux-x64.jarLinux x86_64 ~0.8 MB target/RecheckScan-mac-arm64.jarmacOS Apple Silicon ~0.9 MB Bản đầy đủ nặng hơn vì mang native library SQLite cho cả Windows, Linux và macOS (x86_64 lẫn aarch64); các bản còn lại chỉ mang đúng một native nên nhẹ hơn ~4 lần.
-
Xác nhận cài đặt:
- Tab mới "Recheck Scan" sẽ xuất hiện
- Kiểm tra log output trong Extensions
-
Vào tab Settings:
- Cấu hình đường dẫn lưu database
- Thiết lập file extensions cần loại trừ
- Bật/tắt các tính năng highlight và note
-
Áp dụng cài đặt:
- Click nút
Applyđể lưu cấu hình - Database sẽ được tạo/tải lại tự động
- Click nút
-
Thu thập API:
- Browse target application
- APIs sẽ tự động được ghi nhận
-
Quản lý trạng thái:
- Vào tab
Unscannedxem APIs chưa quét - Send to Scanner hoặc đánh dấu Rejected
- Theo dõi tiến độ trong Statistics
- Vào tab
-
Theo dõi kết quả:
- Tab
Logshiển thị tổng quan - Sử dụng search để tìm API cụ thể
- Copy đường dẫn với Ctrl+C
- Tab
RecheckScanApiExtension
├── DatabaseManager # Quản lý SQLite database
├── SettingsPanel # Giao diện cài đặt
└── HttpHandler # Xử lý HTTP traffic
graph TD
A[HTTP Request/Response] --> B[HttpHandler]
B --> C{Tool Source?}
C -->|Scanner| D[Process Scanned Params]
C -->|Proxy/Repeater| E[Extract Parameters]
D --> F[DatabaseManager]
E --> F
F --> G[SQLite Database]
G --> H[UI Update]
CREATE TABLE api_log (
id INTEGER PRIMARY KEY AUTOINCREMENT,
method TEXT NOT NULL,
host TEXT NOT NULL,
path TEXT NOT NULL,
unscanned_params TEXT, -- Tham số chưa quét
scanned_params TEXT, -- Tham số đã quét
is_scanned BOOLEAN DEFAULT 0, -- Đã quét xong
is_rejected BOOLEAN DEFAULT 0, -- Bị từ chối
is_bypassed BOOLEAN DEFAULT 0, -- Tự động bypass
is_from_repeater BOOLEAN DEFAULT 0, -- Từ Repeater
last_seen TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
UNIQUE(host, path, method)
);Được lưu tại: %USERPROFILE%\AppData\Local\RecheckScan\scan_api.txt
.js,.svg,.css,.png,.jpg,.ttf,.ico,.html,.map,.gif,.woff2,.bcmap,.jpeg,.woff
false
false
C:\Path\To\Database\scan_api.db
true
404,405
# Các file static thường loại trừ
.js, .css, .png, .jpg, .gif, .ico
.svg, .ttf, .woff, .woff2
.html, .map, .bcmap
- Chỉ áp dụng cho API method GET
- Chỉ bypass khi không có tham số nào
- Không override API đã được scan/reject
src/main/java/com/example/
├── DatabaseManager.java # Core database operations
├── RecheckScanApiExtension.java # Main extension class
└── SettingsPanel.java # UI settings panel
# Compile
mvn clean compile
# Run tests
mvn test
# Package
mvn package
# Install dependencies
mvn dependency:resolveExtension sử dụng Montoya API logging:
- Output: Thông tin hoạt động bình thường
- Errors: Lỗi và exceptions
- Enable trong Extensions → Output
-
Database connection failed:
- Check quyền ghi thư mục
- Verify đường dẫn database path
-
UI không cập nhật:
- Check Extension output log
- Restart Burp Suite
-
Không detect API:
- Verify target trong Scope
- Check excluded extensions
- Kiểm tra status code filters
- Large database: Sử dụng pagination
- Memory usage: Giới hạn table rows hiển thị
- Slow scanning: Check excluded patterns
- ✅ Migration từ CSV sang SQLite
- ✅ Thêm auto-bypass functionality
- ✅ Cải thiện UI với tabs riêng biệt
- ✅ Thread-safe database operations
- ✅ Better error handling
- ✅ Basic API detection
- ✅ CSV export functionality
- ✅ Manual status management
- Fork project
- Tạo feature branch (
git checkout -b feature/AmazingFeature) - Commit changes (
git commit -m 'Add some AmazingFeature') - Push to branch (
git push origin feature/AmazingFeature) - Tạo Pull Request
Project này được phân phối dưới MIT License. Xem LICENSE file để biết thêm chi tiết.
- Phát triển bởi vn-ncvinh
- Sử dụng Montoya API
- Database: SQLite với JDBC driver
- GitHub Issues: Create Issue
- Email: Contact
⭐ Star project này nếu nó hữu ích cho bạn!