Log4Scan
A simple automatic tool for finding vulnerable log4j hosts
Installation
pip3 install -r requirements.txt
Usage
usage: log4scan.py [-h] (-f FILENAME | -e ENDPOINT) [--http] [--https] [-p PAYLOAD] [--host HOST] [-o OUTPUT_FILE] [-m MAPPING_FILE] [-t TIMEOUT] [-v]
[--headers-file HEADERS] [--manual] [--proxy PROXY] [--token INTERACT_TOKEN] [--headers] [--query] [--path]
options:
-h, --help show this help message and exit
-f FILENAME, --filename FILENAME
file to use as a source of endpoints (format IP:PORT)
-e ENDPOINT, --endpoint ENDPOINT
endpoint to test
--http Test HTTP on domains without explicit schema
--https Test HTTPS on domains without explicit schema
-p PAYLOAD, --payload PAYLOAD
template of the testing payload to use
--host HOST host to send LDAP request [default: interactsh.com]
-o OUTPUT_FILE, --output OUTPUT_FILE
output file with vulnerable hosts
-m MAPPING_FILE, --mappings MAPPING_FILE
output file with ID<->Endpoint mapping
-t TIMEOUT, --timeout TIMEOUT
request timeout [default: 10]
-v, --verbose verbose logging
--headers-file HEADERS
file with a list of header to test
--manual do not run automatic verification and use the simple payload instead
--proxy PROXY send requests through proxy
--token INTERACT_TOKEN
Custom interact.sh token
Tests:
[default: Headers, Query, Path]
--headers test headers injection like user-agent and referer
--query test query injection in GET request as id parameter
--path test path injection
Basic Usage
Automatically test a single endpoint
python3 log4scan.py -e https://vulnerablemachine.com
Automatically test multiple endpoints defined in a file
python3 log4scan.py -f ./hosts.txt
Manually test multiple endpoints defined in a file with private host
python3 log4scan.py -f ./hosts.txt --manual --host privatehost.net
Manually test multiple endpoints defined in a file with custom payload and private host
python3 log4scan.py -f ./hosts.txt --manual --payload '${jndi:ldap://HOST/customprefix-ID}' --host privatehost.net
Automatically test multiple endpoints defined in a file and generate two files containing the mappings between ID and endpoints and the vulnerable endpoints
python3 log4scan.py -f ./hosts.txt -m ./mapping.csv -o ./vulnerable-endpoints.txt
Docker
Execute from image
docker run --name log4scan ghcr.io/fuji97/log4scan
Build and execute yourself
docker build . -t log4scan
docker run --name log4scan log4scan
License
This project is licensed under MIT License
Authors:
- Federico Rapetti
- Reply Communication Valley: https://www.linkedin.com/company/communication-valley
13 Jul 13, 2022
560 Dec 23, 2022
431 Dec 22, 2022
8 Feb 27, 2022
6 Jan 30, 2022
2 Jun 6, 2022
26 Dec 26, 2022
309 Jan 2, 2023
187 Jan 3, 2023
764 Jan 05, 2023
4 Feb 24, 2022
9 Dec 17, 2022
2 Jan 25, 2022
67 Nov 09, 2022
14 Aug 17, 2022
191 Dec 22, 2022
9 Oct 05, 2022
91 Dec 29, 2022
![Trewis [work] Scotch](https://avatars.githubusercontent.com/u/92666826?v=4&s=60)
4 Sep 23, 2022
3 Dec 06, 2021
12 Nov 18, 2022
20 Apr 07, 2022
5 May 31, 2022
14 Nov 26, 2022
1.5k Dec 31, 2022
45 Dec 20, 2022
893 Jan 04, 2023
1 Jan 13, 2022
104 Nov 09, 2022