Skip to main content

Open Redirect Bug Finding Tool

Project description

Open Redirect Bug Finder Tool :

This tool scans URLs for potential open redirect vulnerabilities. It is structured into multiple files for better modularity and maintainability.

Project Structure :

openred/
│
├── main.py 
├── packages/
│ └── includes/
│ ├── init.py 
│ ├── file.py 
│ ├── scan.py 
│ └── write.py 
└── units/
├── init.py 
├── banner.py 
├── chknet.py 
└── urls.py 

How to Set Up :

  1. Clone the repository:

    git clone <repository_url> cd openred

  2. Install the necessary packages:

    pip install -r requirements.txt

  3. Make sure the directory structure is correct:

    • The main.py should be at the root level (openred/).
    • The packages/ and units/ directories should contain their respective files as shown above.

How to Run :

To use this tool, run the main.py file with the appropriate arguments:

python main.py -u -o <output_file>

Example:

python main.py -u http://example.com -o output.txt

Arguments -u or --url: Enter the URL to scan for open redirect vulnerabilities. -i or --input: Enter the input file name to read URLs from (optional). -o or --output: Enter the output file name to save the scan results. -b or --blog: Opens the specified blog URL in the browser.

Explanation of Modules : >>main.py: The main script that parses command-line arguments and triggers the relevant functions.

>>units/banner.py: Displays a welcome banner when the tool is run.

>>units/chknet.py: Checks if there is an active internet connection before proceeding with scans.

>>units/urls.py: Contains URL-related data, such as the blog URL.

>>packages/includes/file.py: Handles reading from and writing to files.

>>packages/includes/scan.py: Contains the logic to scan URLs for open redirect vulnerabilities.

>>packages/includes/write.py: Handles writing scan results to the specified output file.

Example Workflow :
>>Check for Network: Before starting, the tool checks if the internet connection is available.
>>Display Banner: A welcome banner is displayed to the user.
>>Scan URL: The tool scans the provided URL for open redirect vulnerabilities.
>>Read/Write Files: If an input file is provided, the tool reads URLs from it. Results are written to the specified output file.
>>Open Blog: If the --blog option is used, the tool opens the specified blog URL in the browser.

License ✔️This project is licensed under the MIT License. See the LICENSE file for details.

Contributing Fork the repository. Create a new branch (git checkout -b feature-branch). Commit your changes (git commit -am 'Add new feature'). Push to the branch (git push origin feature-branch). Create a new Pull Request. Contact For any issues or questions, please open an issue on GitHub.


Thank you for using the Open Redirect Bug Finder Tool!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openredirectscanner-0.1.3.tar.gz (3.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openredirectscanner-0.1.3-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

Details for the file openredirectscanner-0.1.3.tar.gz.

File metadata

  • Download URL: openredirectscanner-0.1.3.tar.gz
  • Upload date:
  • Size: 3.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.12.0

File hashes

Hashes for openredirectscanner-0.1.3.tar.gz
Algorithm Hash digest
SHA256 ae13f800b89ff0f57b3fa5a69c65852e09dfdc89ab5e94193807c58b8bd51b5c
MD5 cb9299dae824791168926198d6a7d443
BLAKE2b-256 d3039a3a02ccff7b62220e4c9968cff7f6b1d35956a2c3a4eecd20593cc8555e

See more details on using hashes here.

File details

Details for the file openredirectscanner-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for openredirectscanner-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 0f93d2960da9c97419292eef234025aa318837cf441169574346b423a4e9c671
MD5 352c561ef91d13322a3685348aa3ef52
BLAKE2b-256 c6f3deb9f27e3f39803dbde4a3d4de17fc8ef8cc71a41e5bb3793b7dd77136d2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page