forked from GhostTroops/scan4all
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
28 changed files
with
1,861 additions
and
47 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,154 @@ | ||
# Editors | ||
.vscode/ | ||
.idea/ | ||
|
||
# Vagrant | ||
.vagrant/ | ||
|
||
# Mac/OSX | ||
.DS_Store | ||
|
||
# Windows | ||
Thumbs.db | ||
|
||
# Byte-compiled / optimized / DLL files | ||
__pycache__/ | ||
*.py[cod] | ||
*$py.class | ||
|
||
# C extensions | ||
*.so | ||
|
||
# Distribution / packaging | ||
.Python | ||
build/ | ||
develop-eggs/ | ||
dist/ | ||
downloads/ | ||
eggs/ | ||
.eggs/ | ||
lib/ | ||
lib64/ | ||
parts/ | ||
sdist/ | ||
var/ | ||
wheels/ | ||
share/python-wheels/ | ||
*.egg-info/ | ||
.installed.cfg | ||
*.egg | ||
MANIFEST | ||
|
||
# PyInstaller | ||
# Usually these files are written by a python script from a template | ||
# before PyInstaller builds the exe, so as to inject date/other infos into it. | ||
*.manifest | ||
*.spec | ||
|
||
# Installer logs | ||
pip-log.txt | ||
pip-delete-this-directory.txt | ||
|
||
# Unit test / coverage reports | ||
htmlcov/ | ||
.tox/ | ||
.nox/ | ||
.coverage | ||
.coverage.* | ||
.cache | ||
nosetests.xml | ||
coverage.xml | ||
*.cover | ||
*.py,cover | ||
.hypothesis/ | ||
.pytest_cache/ | ||
cover/ | ||
|
||
# Translations | ||
*.mo | ||
*.pot | ||
|
||
# Django stuff: | ||
*.log | ||
local_settings.py | ||
db.sqlite3 | ||
db.sqlite3-journal | ||
|
||
# Flask stuff: | ||
instance/ | ||
.webassets-cache | ||
|
||
# Scrapy stuff: | ||
.scrapy | ||
|
||
# Sphinx documentation | ||
docs/_build/ | ||
|
||
# PyBuilder | ||
.pybuilder/ | ||
target/ | ||
|
||
# Jupyter Notebook | ||
.ipynb_checkpoints | ||
|
||
# IPython | ||
profile_default/ | ||
ipython_config.py | ||
|
||
# pyenv | ||
# For a library or package, you might want to ignore these files since the code is | ||
# intended to run in multiple environments; otherwise, check them in: | ||
# .python-version | ||
|
||
# pipenv | ||
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. | ||
# However, in case of collaboration, if having platform-specific dependencies or dependencies | ||
# having no cross-platform support, pipenv may install dependencies that don't work, or not | ||
# install all needed dependencies. | ||
#Pipfile.lock | ||
|
||
# PEP 582; used by e.g. github.com/David-OConnor/pyflow | ||
__pypackages__/ | ||
|
||
# Celery stuff | ||
celerybeat-schedule | ||
celerybeat.pid | ||
|
||
# SageMath parsed files | ||
*.sage.py | ||
|
||
# Environments | ||
.env | ||
.venv | ||
env/ | ||
venv/ | ||
ENV/ | ||
env.bak/ | ||
venv.bak/ | ||
|
||
# Spyder project settings | ||
.spyderproject | ||
.spyproject | ||
|
||
# Rope project settings | ||
.ropeproject | ||
|
||
# mkdocs documentation | ||
/site | ||
|
||
# mypy | ||
.mypy_cache/ | ||
.dmypy.json | ||
dmypy.json | ||
|
||
# Pyre type checker | ||
.pyre/ | ||
|
||
# pytype static type analyzer | ||
.pytype/ | ||
|
||
# Cython debug symbols | ||
cython_debug/ | ||
|
||
# Smuggler results | ||
payloads/*.txt |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,21 @@ | ||
MIT License | ||
|
||
Copyright (c) 2020 Evan Custodio | ||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy | ||
of this software and associated documentation files (the "Software"), to deal | ||
in the Software without restriction, including without limitation the rights | ||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
copies of the Software, and to permit persons to whom the Software is | ||
furnished to do so, subject to the following conditions: | ||
|
||
The above copyright notice and this permission notice shall be included in all | ||
copies or substantial portions of the Software. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
SOFTWARE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,139 @@ | ||
``` | ||
______ _ | ||
/ _____) | | | ||
( (____ ____ _ _ ____ ____| | _____ ____ | ||
\____ \| \| | | |/ _ |/ _ | || ___ |/ ___) | ||
_____) ) | | | |_| ( (_| ( (_| | || ____| | | ||
(______/|_|_|_|____/ \___ |\___ |\_)_____)_| | ||
(_____(_____| | ||
@defparam | ||
``` | ||
|
||
# Smuggler | ||
|
||
An HTTP Request Smuggling / Desync testing tool written in Python 3 | ||
|
||
## Acknowledgements | ||
|
||
A special thanks to [James Kettle](https://skeletonscribe.net/) for his [research and methods into HTTP desyncs](https://portswigger.net/research/http-desync-attacks-request-smuggling-reborn) | ||
|
||
And a special thanks to [Ben Sadeghipour](https://www.nahamsec.com/) for beta testing Smuggler and for allowing me to discuss my work at [Nahamcon 2020](https://nahamcon.com) | ||
|
||
## IMPORTANT | ||
This tool does not guarantee no false-positives or false-negatives. Just because a mutation may report OK does not mean there isn't a desync issue, but more importantly just because the tool indicates a potential desync issue does not mean there definitely exists one. The script may encounter request processors from large entities (i.e. Google/AWS/Yahoo/Akamai/etc..) that may show false positive results. | ||
|
||
## Installation | ||
|
||
1) git clone https://github.com/defparam/smuggler.git | ||
2) cd smuggler | ||
3) python3 smuggler.py -h | ||
|
||
## Example Usage | ||
|
||
Single Host: | ||
``` | ||
python3 smuggler.py -u <URL> | ||
``` | ||
|
||
List of hosts: | ||
``` | ||
cat list_of_hosts.txt | python3 smuggler.py | ||
``` | ||
|
||
## Options | ||
|
||
``` | ||
usage: smuggler.py [-h] [-u URL] [-v VHOST] [-x] [-m METHOD] [-l LOG] [-q] | ||
[-t TIMEOUT] [--no-color] [-c CONFIGFILE] | ||
optional arguments: | ||
-h, --help show this help message and exit | ||
-u URL, --url URL Target URL with Endpoint | ||
-v VHOST, --vhost VHOST | ||
Specify a virtual host | ||
-x, --exit_early Exit scan on first finding | ||
-m METHOD, --method METHOD | ||
HTTP method to use (e.g GET, POST) Default: POST | ||
-l LOG, --log LOG Specify a log file | ||
-q, --quiet Quiet mode will only log issues found | ||
-t TIMEOUT, --timeout TIMEOUT | ||
Socket timeout value Default: 5 | ||
--no-color Suppress color codes | ||
-c CONFIGFILE, --configfile CONFIGFILE | ||
Filepath to the configuration file of payloads | ||
``` | ||
|
||
Smuggler at a minimum requires either a URL via the -u/--url argument or a list of URLs piped into the script via stdin. | ||
If the URL specifies `https://` then Smuggler will connect to the host:port using SSL/TLS. If the URL specifies `http://` | ||
then no SSL/TLS will be used at all. If only the host is specified, then the script will default to `https://` | ||
|
||
Use -v/--vhost \<host> to specify a different host header from the server address | ||
|
||
Use -x/--exit_early to exit the scan of a given server when a potential issue is found. In piped mode smuggler will just continue to the next host on the list | ||
|
||
Use -m/--method \<method> to specify a different HTTP verb from POST (i.e GET/PUT/PATCH/OPTIONS/CONNECT/TRACE/DELETE/HEAD/etc...) | ||
|
||
Use -l/--log \<file> to write output to file as well as stdout | ||
|
||
Use -q/--quiet reduce verbosity and only log issues found | ||
|
||
Use -t/--timeout \<value> to specify the socket timeout. The value should be high enough to conclude that the socket is hanging, but low enough to speed up testing (default: 5) | ||
|
||
Use --no-color to suppress the output color codes printed to stdout (logs by default don't include color codes) | ||
|
||
Use -c/--configfile \<configfile> to specify your smuggler mutation configuration file (default: default.py) | ||
|
||
## Config Files | ||
Configuration files are python files that exist in the ./config directory of smuggler. These files describe the content of the HTTP requests and the transfer-encoding mutations to test. | ||
|
||
|
||
Here is example content of default.py: | ||
```python | ||
def render_template(gadget): | ||
RN = "\r\n" | ||
p = Payload() | ||
p.header = "__METHOD__ __ENDPOINT__?cb=__RANDOM__ HTTP/1.1" + RN | ||
# p.header += "Transfer-Encoding: chunked" +RN | ||
p.header += gadget + RN | ||
p.header += "Host: __HOST__" + RN | ||
p.header += "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.87 Safari/537.36" + RN | ||
p.header += "Content-type: application/x-www-form-urlencoded; charset=UTF-8" + RN | ||
p.header += "Content-Length: __REPLACE_CL__" + RN | ||
return p | ||
|
||
|
||
mutations["nameprefix1"] = render_template(" Transfer-Encoding: chunked") | ||
mutations["tabprefix1"] = render_template("Transfer-Encoding:\tchunked") | ||
mutations["tabprefix2"] = render_template("Transfer-Encoding\t:\tchunked") | ||
mutations["space1"] = render_template("Transfer-Encoding : chunked") | ||
|
||
for i in [0x1,0x4,0x8,0x9,0xa,0xb,0xc,0xd,0x1F,0x20,0x7f,0xA0,0xFF]: | ||
mutations["midspace-%02x"%i] = render_template("Transfer-Encoding:%cchunked"%(i)) | ||
mutations["postspace-%02x"%i] = render_template("Transfer-Encoding%c: chunked"%(i)) | ||
mutations["prespace-%02x"%i] = render_template("%cTransfer-Encoding: chunked"%(i)) | ||
mutations["endspace-%02x"%i] = render_template("Transfer-Encoding: chunked%c"%(i)) | ||
mutations["xprespace-%02x"%i] = render_template("X: X%cTransfer-Encoding: chunked"%(i)) | ||
mutations["endspacex-%02x"%i] = render_template("Transfer-Encoding: chunked%cX: X"%(i)) | ||
mutations["rxprespace-%02x"%i] = render_template("X: X\r%cTransfer-Encoding: chunked"%(i)) | ||
mutations["xnprespace-%02x"%i] = render_template("X: X%c\nTransfer-Encoding: chunked"%(i)) | ||
mutations["endspacerx-%02x"%i] = render_template("Transfer-Encoding: chunked\r%cX: X"%(i)) | ||
mutations["endspacexn-%02x"%i] = render_template("Transfer-Encoding: chunked%c\nX: X"%(i)) | ||
``` | ||
|
||
There are no input arguments yet on specifying your own customer headers and user-agents. It is recommended to create your own configuration file based on default.py and modify it to your liking. | ||
|
||
Smuggler comes with 3 configuration files: default.py (fast), doubles.py (niche, slow), exhaustive.py (very slow) | ||
default.py is the fastest because it contains less mutations. | ||
|
||
specify configuration files using the -c/--configfile \<configfile> command line option | ||
|
||
## Payloads Directory | ||
Inside the Smuggler directory is the payloads directory. When Smuggler finds a potential CLTE or TECL desync issue, it will automatically dump a binary txt file of the problematic payload in the payloads directory. All payload filenames are annotated with the hostname, desync type and mutation type. Use these payloads to netcat directly to the server or to import into other analysis tools. | ||
|
||
## Helper Scripts | ||
After you find a desync issue feel free to use my Turbo Intruder desync scripts found Here: https://github.com/defparam/tiscripts | ||
`DesyncAttack_CLTE.py` and `DesyncAttack_TECL.py` are great scripts to help stage a desync attack | ||
|
||
## License | ||
These scripts are released under the MIT license. See [LICENSE](https://github.com/defparam/smuggler/blob/master/LICENSE). |
Oops, something went wrong.