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.2.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.2-py3-none-any.whl (4.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: openredirectscanner-0.1.2.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.2.tar.gz
Algorithm Hash digest
SHA256 fd7b05b896e21ee011519efcc1bf51e2878fe563eba50daf36871d6b11ea0bc6
MD5 05b1d99c74861632c2593745356386a9
BLAKE2b-256 805e8ff9d73e7e6b0df4371361e902060042070bcff4d2dd41d74fdba76f263e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for openredirectscanner-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5ae66760670c6636ad03793c9f66fa869cb497fcf270b7f08d6323d683998863
MD5 c009f2b21a6bdfe4e32a7b7f7431ae16
BLAKE2b-256 9f9ca3ef518c68d5029f3b12ad577c79180b82b85a1d6f8b8625d5c67e7b5cd4

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