ArgusScan: The Vigilant Protector

Inspired by the vigilant giant Argus Panoptes from Greek mythology, ArgusScan is your watchful guardian in the realm of the web, designed to seek out vulnerabilities and keep your applications secure. Just like Argus with his hundred watchful eyes, ArgusScan scrutinizes web applications from multiple perspectives, ensuring no vulnerability goes unnoticed. Embrace the protection of ArgusScan and fortify your digital domains against the unknown threats lurking in the shadows!

Overview

This repository contains a shell script designed to automate the process of launching OWASP ZAP, conducting a scan, and generating a report. The addition of Nmap functionality allows for comprehensive network scanning. The script is primarily intended for use with Kali Linux and Zsh shell, but it can be modified for use with other Linux distributions and shell environments.

Updates

• [2023-09-22]: Introduced Nmap functionality and refined ZAP scanner component for better efficiency.
• [2023-09-22]: Enhanced README documentation with additional instructions and recommendations.

Features

• Automatic initialization of OWASP ZAP in daemon mode.
• Integration with Nmap for extensive network scanning.
• Target URL parameterization.
• Automatic report generation with a unique name.
• Report storage in a designated folder.

Prerequisites

• OWASP ZAP installed.
• zap-cli installed.
• Nmap installed.
• Git (for cloning the repository).

Installing zap-cli

It is recommended to create and activate a Python virtual environment and install zapcli within this environment to avoid conflicts between different versions of packages:

python3 -m venv myenv
source myenv/bin/activate  # On Windows, use `myenv\Scripts\activate`
pip install zapcli

Usage

1. Clone this repository: ```sh git clone https://github.com/boukhrisssaber/zap_scan cd zap_scan ```
2. Make the script executable: ```sh chmod +x zap_scan.sh ```
3. Run the script with the target URL as a parameter: ```sh ./zap_scan.sh <target_url> ```

Output

The script will create a new report in the `scan_reports` folder, with the name format `report_<website_name>_.html`.

Contributing

Feel free to fork this project, create a feature branch, and submit a pull request.

License

This project is open source, under the MIT License." > README.md