OneScan : A Comprehensive Tool For Recursive Directory Scanning

OneScan is an innovative Burp Suite plugin designed to enhance vulnerability detection in deeply nested directories of web applications.

Initially conceptualized to identify hidden Swagger-API documentation, OneScan has evolved into a versatile tool capable of uncovering sensitive information leaks, unauthorized access points, and privilege escalation vulnerabilities.

Core Features And Functionality

OneScan operates by recursively scanning directories, leveraging payload dictionaries to probe for hidden endpoints.

For example, given a target URL https://www.example.com/a/b/c/xyz.js, OneScan systematically scans paths like /api-docs or /{{domain.name}}.zip across all directory levels. This recursive approach ensures comprehensive coverage of potential vulnerabilities.

Key functionalities include:

• Dynamic Payloads: Supports a variety of dynamic variables (e.g., {{host}}, {{domain}}, {{timestamp}}) to adapt scans based on the target’s structure.
• Active and Passive Scanning: Users can initiate scans directly or passively analyze intercepted traffic.
• Fingerprinting: Version 1.0.0 introduces a fingerprinting module to identify software and hardware characteristics, aiding in vulnerability assessments.
• Data Visualization: A data board provides insights into scan results, including JSON field extraction and directory enumeration.

Installing OneScan in Burp Suite involves navigating to the “Extender” tab, adding the plugin’s JAR file, and configuring dependencies like the HaE plugin for enhanced logging and data highlighting.

Configuration files are stored in platform-specific directories (e.g., ~/.config/OneScan/ for Linux).

Users can customize:

• Payload Dictionaries: Define specific paths or patterns for recursive scanning.
• Request Settings: Adjust parameters like QPS (queries per second), retry attempts, and request headers.
• Host Management: Configure blacklists or whitelists to refine scan targets.

OneScan’s auxiliary panel extracts JSON fields from requests and responses, while its filtering system allows users to set temporary or permanent rules for data analysis.

The plugin also supports integration with external tools like HaE for sensitive data highlighting.

OneScan is ideal for:

• Identifying undocumented API endpoints.
• Detecting sensitive file disclosures (e.g., ZIP archives).
• Testing access controls on hidden resources.

With its robust features and ease of use, OneScan empowers security professionals to uncover vulnerabilities in complex directory structures efficiently.