This script scans websites for security headers and saves the results to a file. It uses the Headers Doctor API (https://headers.doctor/) to perform the scans.
- Scan a single URL or a list of URLs from a file.
- Specify the port to use for scanning.
- Save the scan results to a JSON file.
- Save temporary files for later retrieval of results.
- Get scan results from previously saved temporary files or by providing a specific UUID.
- Python 3.7 or higher
- requests library
- Install the requests library:
pip install requests- Clone the repository or download the
scan_headers.pyfile.
python scan_headers.py [OPTIONS]| Option | Description |
|---|---|
-u, --scan_by_url |
URL to scan. |
-p, --port |
Port to use for scanning (default: 443). |
-f, --file |
File containing a list of URLs to scan. |
-s, --save_response_to_file |
Directory path to save the scan results to a JSON file. |
--save_temp |
Save temporary files for later retrieval of results. |
--get_result_from_file |
Get scan results from a file containing a list of UUIDs and ports. |
--get_result_from_uuid |
Get the scan result for a specific UUID. |
Scan a single URL and print the results to the console:
python scan_headers.py -u https://www.example.comScan a list of URLs from a file and save the results to a file:
python scan_headers.py -f urls.txt -s results.jsonScan a URL on a specific port:
python scan_headers.py -u https://www.example.com -p 8080Save temporary files and retrieve the results later:
python scan_headers.py -u https://www.example.com --save_temp python scan_headers.py --get_result_from_fileGet the scan result for a specific UUID:
python scan_headers.py --get_result_from_uuid- The script uses asynchronous operations to speed up the scanning process.
- The temporary files are saved in a directory named
temp_<timestamp>. - The scan results are saved in JSON format.
- The script logs events to the console and to a file named
scan_headers.log.
This project is licensed under the terms of the GNU General Public License (GPL) Version 3.