Skip to content

Commit 623f831

Browse files
committed
5.2.0
1 parent f2b584d commit 623f831

File tree

9 files changed

+8886
-158
lines changed

9 files changed

+8886
-158
lines changed

CHANGELOG.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,7 @@
11
# Changelog
2+
5.2.0 - 2021-10-03
3+
---------
4+
- added asynchronous execution
25

36
5.1.0 - 2021-03-31
47
---------

README.md

Lines changed: 23 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -1,62 +1,45 @@
1-
# Knock Subdomain Scan v5.1.0
1+
# Knock Subdomain Scan v5.2.0
22

3-
Knockpy is a python3 tool designed to enumerate subdomains on a target domain through dictionary attack.
3+
Knockpy is a python3 tool designed to quickly enumerate subdomains on a target domain through dictionary attack.
44

55
![knockpy5](https://user-images.githubusercontent.com/41558/111915750-1bad8f80-8a78-11eb-951a-d5da1adc2bdc.png)
66

77
### Very simply
8-
```$ knockpy domain.com```
8+
```python3 knockpy.py domain.com```
99

1010
# Install
1111

1212
###### You need python3, pip3, git.
1313

14-
```$ git clone https://github.com/guelfoweb/knock.git```
15-
16-
__Choose one of the three installation methods__
17-
18-
**Install in the __global__ site-packages directory:**
19-
20-
###### as root
21-
22-
```# python3 setup.py install```
23-
24-
**Install in the __user__ site-packages directory:**
25-
26-
```$ python3 setup.py install --user```
27-
28-
**Use virtualenv + pip**
29-
30-
```$ virtualenv --python=python3 venv3```
31-
32-
```$ source venv3/bin/activate```
33-
34-
```$ pip3 install -r requirements.txt```
35-
36-
Are you looking for a [dockerized image of knockpy](https://github.com/guelfoweb/knock#knockpy-docker)?
37-
14+
```
15+
git clone https://github.com/guelfoweb/knock.git
16+
cd knock
17+
pip3 install -r requirements.txt
18+
python3 knockpy.py <DOMAIN>
19+
```
3820

3921
# Knockpy -h
4022

4123
```
42-
usage: knockpy [-h] [-v] [--no-local] [--no-remote] [--no-http] [--no-http-code CODE [CODE ...]] [-w WORDLIST] [-o FOLDER] [-t SEC] domain
24+
usage: knockpy [-h] [-v] [--no-local] [--no-remote] [--no-http] [--no-http-code CODE [CODE ...]]
25+
[-w WORDLIST] [-o FOLDER] [-t SEC] [-th NUM] domain
4326
4427
--------------------------------------------------------------------------------
4528
* SCAN
46-
full scan: knockpy domain.com
47-
fast scan: knockpy domain.com --no-http
48-
quick scan: knockpy domain.com --no-http --no-local
29+
full scan: knockpy domain.com
4930
ignore code: knockpy domain.com --no-http-code 404 500 530
50-
timeout: knockpy domain.com -t 2
31+
threads: knockpy domain.com -th 50
32+
timeout: knockpy domain.com -t 2
5133
5234
* REPORT
5335
show report: knockpy --report knockpy_report/domain.com_yyyy_mm_dd_hh_mm_ss.json
5436
plot report: knockpy --plot knockpy_report/domain.com_yyyy_mm_dd_hh_mm_ss.json
55-
csv report: knockpy --csv knockpy_report/domain.com_yyyy_mm_dd_hh_mm_ss.json
37+
csv report: knockpy --csv knockpy_report/domain.com_yyyy_mm_dd_hh_mm_ss.json
5638
5739
* SETTINGS
58-
set apikey: knockpy --set apikey-virustotal=APIKEY
40+
set apikey: knockpy --set apikey-virustotal=APIKEY
5941
set timeout: knockpy --set timeout=sec
42+
set threads: knockpy --set threads=num
6043
--------------------------------------------------------------------------------
6144
6245
positional arguments:
@@ -75,6 +58,7 @@ optional arguments:
7558
-w WORDLIST wordlist file to import
7659
-o FOLDER report folder to store json results
7760
-t SEC timeout in seconds
61+
-th NUM threads num
7862
7963
```
8064

@@ -97,6 +81,11 @@ optional arguments:
9781
- DNS requests only, no http(s) requests will be made. This way the response will be much faster and you will get the IP address and the Subdomain.
9882
- The subdomain will be cyan in color if it is an ```alias``` and in that case the real host name will also be provided.
9983

84+
### Set threads
85+
```$ knockpy domain.com -th 50```
86+
87+
- default threads = ```30```
88+
10089
### Set timeout
10190
```$ knockpy domain.com -t 5```
10291

@@ -170,14 +159,6 @@ Report example ```domain.com_yyyy_mm_dd_hh_mm_ss.json```:
170159

171160
```_meta``` is a reserved key that contains the basic information of the scan.
172161

173-
### Knockpy docker
174-
175-
A dockerized image is hosted on [nocommentlab/knock](https://hub.docker.com/r/nocommentlab/knock) a project of [Antonio Blescia](https://github.com/nocommentlab).
176-
177-
You can use classic docker commands or run [kdocker](https://raw.githubusercontent.com/guelfoweb/knock/master/kdocker) script.
178-
179-
```./kdocker domain.com <arg1> <arg2> <argn>```
180-
181162
# License
182163

183164
Knockpy is currently under development by [@guelfoweb](https://twitter.com/guelfoweb) and it's released under the GPL 3 license.

kdocker

Lines changed: 0 additions & 18 deletions
This file was deleted.

knockpy.py

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
#!/usr/bin/python3
2+
# -*- coding: utf-8 -*-
3+
4+
from knockpy import knockpy
5+
knockpy.main()

knockpy/config.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
"Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:65.0) Gecko/20100101 Firefox/65.0"
1010
],
1111
"timeout": 3,
12+
"threads": 30,
1213
"wordlist": {
1314
"local": "wordlist.txt",
1415
"remote": [

0 commit comments

Comments
 (0)