🎉 v2.0 release!!!

This commit is contained in:
k4m4 2018-02-05 21:39:08 +02:00
parent 0099733382
commit 993ec221e3
No known key found for this signature in database
GPG Key ID: C747F75367032D1E
10 changed files with 815 additions and 487 deletions

1
.gitignore vendored
View File

@ -25,3 +25,4 @@ ENV/
*.tmp *.tmp
*.bak *.bak
*.cfg *.cfg
__pycache__/

View File

@ -1,6 +1,9 @@
language: python language: python
python: python:
- "2.6" - "3.4"
- "2.7" - "3.5"
- "3.6"
install:
- pip3 install -r requirements.txt
script: script:
- python -c "import kickthemout; import scan; import spoof" - python -c "import kickthemout; import scan; import spoof"

View File

@ -1,4 +0,0 @@
0.1 (05.01.2017)
----------------
- Initial release.

View File

@ -1,6 +1,6 @@
MIT License MIT License
Copyright (c) 2017 Nikolaos Kamarinakis Copyright (c) 2017-18 Nikolaos Kamarinakis
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal

View File

@ -1,109 +0,0 @@
.. image:: http://nikolaskama.me/content/images/2017/02/kickthemout_small.png
KickThemOut
============
`KickThemOut <https://nikolaskama.me/kickthemoutproject/>`_ - **Kick Devices Off Your Network**
A tool to kick devices out of your network and enjoy all the bandwidth for yourself.
It allows you to select specific or all devices and ARP spoofs them off your local area network.
Compatible with Python 2.6 & 2.7.
Authors: `Nikolaos Kamarinakis <mailto:nikolaskam@gmail.com>`_ & `David Schütz <mailto:xdavid@protonmail.com>`_.
.. image:: https://travis-ci.org/k4m4/kickthemout.svg?branch=master
:target: https://travis-ci.org/k4m4/kickthemout
.. image:: https://img.shields.io/badge/license-MIT-blue.svg
:target: https://github.com/k4m4/kickthemout/blob/master/LICENSE
.. image:: https://img.shields.io/badge/made%20with-%3C3-red.svg
:target: https://nikolaskama.me/kickthemoutproject
.. image:: https://img.shields.io/github/stars/k4m4/kickthemout.svg
:target: https://github.com/k4m4/kickthemout/stargazers
-------------
Debian Installation
----------------------
You can download KickThemOut by cloning the `Git Repo <https://github.com/k4m4/kickthemout>`_ and simply installing its requirements::
$ sudo apt-get update && sudo apt-get install nmap
$ git clone https://github.com/k4m4/kickthemout.git
$ cd kickthemout/
$ sudo -H pip install --upgrade pip
$ sudo -H python -m pip install -r requirements.txt
$ sudo python kickthemout.py
MacOS Installation
----------------------
If you would like to install KickThemOut on a Mac, please run the following::
$ sudo -H pip install --upgrade pip
$ sudo -H pip install pcapy
$ brew update
$ brew install --with-python libdnet nmap
**Keep in mind** that you might be asked to run some commands after executing the previous step. Moving on::
$ git clone https://github.com/k4m4/kickthemout.git
$ cd kickthemout/
$ sudo -H pip install -r requirements.txt
$ sudo python kickthemout.py
**NOTE**: You need to have `Homebrew <http://brew.sh/>`_ installed before running the Mac OS installation.
Arch Installation
----------------------
You can download KickThemOut on an Arch based system by executing the following::
$ yaourt -S kickthemout-git
$ sudo kickthemout
Demo
-----
Here's a short demo:
.. image:: https://nikolaskama.me/content/images/2017/01/kickthemout_asciinema.png
:target: https://asciinema.org/a/98200?autoplay=1&loop=1
(For more demos click `here <https://asciinema.org/~k4m4>`_.)
Developers
-----------
* Nikolaos Kamarinakis - `@nikolaskama <https://twitter.com/nikolaskama>`_
* David Schütz - `@xdavidhu <https://twitter.com/xdavidhu>`_
Disclaimer
-----------
KickThemOut is provided as is under the MIT Licence (as stated below).
It is built for educational purposes only. If you choose to use it otherwise, the developers will not be held responsible.
In brief, do not use it with evil intent.
License
--------
Copyright (c) 2017 by `Nikolaos Kamarinakis <mailto:nikolaskam@gmail.com>`_ & `David Schütz <mailto:xdavid@protonmail.com>`_. Some rights reserved.
KickThemOut is under the terms of the `MIT License <https://www.tldrlegal.com/l/mit>`_, following all clarifications stated in the `license file <https://raw.githubusercontent.com/k4m4/kickthemout/master/LICENSE>`_.
For more information head over to the `official project page <https://nikolaskama.me/kickthemoutproject/>`_.
You can also go ahead and email me anytime at **nikolaskam{at}gmail{dot}com** or David at **xdavid{at}protonmail{dot}com**.

File diff suppressed because it is too large Load Diff

142
readme.md Normal file
View File

@ -0,0 +1,142 @@
![KickThemOut Logo](http://nikolaskama.me/content/images/2017/02/kickthemout_small.png)
# KickThemOut
> [KickThemOut](https://nikolaskama.me/kickthemoutproject) - **Kick Devices Off Your Network**
A tool to kick devices out of your network and enjoy all the bandwidth for yourself.
It allows you to select specific or all devices and ARP spoofs them off your local area network.
- Compatible with Python **3+**🎉.
- *Not* compatible with Windows.
Authors: [Nikolaos Kamarinakis](mailto:nikolaskam@gmail.com) & [David Schütz](mailto:xdavid@protonmail.com).
[![Build Badge](https://travis-ci.org/k4m4/kickthemout.svg?branch=master)](https://travis-ci.org/k4m4/kickthemout)
[![License Badge](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/k4m4/kickthemout/blob/master/LICENSE)
[![GitHub Stars](https://img.shields.io/github/stars/k4m4/kickthemout.svg)](https://github.com/k4m4/kickthemout/stargazers)
-------------
# Installation
## Debian Installation
You can download KickThemOut by cloning the [Git Repo](https://github.com/k4m4/kickthemout) and simply installing its requirements:
```
~ sudo apt-get update && sudo apt-get install nmap
~ git clone https://github.com/k4m4/kickthemout.git
~ cd kickthemout/
~/kickthemout sudo -H pip3 install -r requirements.txt
~/kickthemout sudo python3 kickthemout.py
```
## MacOS Installation
If you would like to install KickThemOut on a Mac, please run the following:
```
~ brew install libdnet
~ git clone https://github.com/k4m4/kickthemout.git
~ cd kickthemout/
~/kickthemout sudo -H pip3 install -r requirements.txt
~/kickthemout sudo python3 kickthemout.py
```
**NOTE**: You need to have [Homebrew](http://brew.sh/) installed before running the Mac OS installation.
Also, **keep in mind** that you might be asked to run some commands after executing the 2nd last command.
## Arch Installation
You can download KickThemOut on an Arch based system by executing the following:
```
~ git clone https://github.com/k4m4/kickthemout.git
~ cd kickthemout/
~ sudo -H pip3 install -r requirements.txt
~/kickthemout sudo python3 kickthemout.py
```
<br/>
# Usage
```
Usage: sudo python3 kickthemout.py [options]
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-p PACKETS, --packets=PACKETS
number of packets broadcasted per minute (default: 6)
-s, --scan perform a quick network scan and exit
-t TARGETS, --target=TARGETS
specify target IP address(es) and perform attack
Examples:
sudo python3 kickthemout.py --target 192.168.1.10
sudo python3 kickthemout.py -t 192.168.1.5,192.168.1.10 -p 30
sudo python3 kickthemout.py (interactive mode)
```
To view all available options run:
```
~/kickthemout sudo python3 kickthemout.py -h
```
<br/>
# Demo
Here's a short demo:
[![Asciinema Demo](https://nikolaskama.me/content/images/2017/01/kickthemout_asciinema.png)](https://asciinema.org/a/98200?autoplay=1&loop=1)
(For more demos click [here](https://asciinema.org/~k4m4))
<br/>
# Developers
* Nikolaos Kamarinakis - [@nikolaskama](https://twitter.com/nikolaskama)
* David Schütz - [@xdavidhu](https://twitter.com/xdavidhu)
<br/>
# Disclaimer
KickThemOut is provided as is under the MIT Licence (as stated below).
It is built for educational purposes *only*. If you choose to use it otherwise, the developers will not be held responsible. Please, do not use it with evil intent.
<br/>
# License
Copyright (c) 2017-18 by [Nikolaos Kamarinakis](mailto:nikolaskam@gmail.com) & [David Schütz](mailto:xdavid@protonmail.com). Some rights reserved.
KickThemOut is under the terms of the [MIT License](https://www.tldrlegal.com/l/mit), following all clarifications stated in the [license file](https://raw.githubusercontent.com/k4m4/kickthemout/master/LICENSE).
For more information head over to the [official project page](https://nikolaskama.me/kickthemoutproject).
You can also go ahead and email me anytime at **nikolaskam{at}gmail{dot}com** or David at **xdavid{at}protonmail{dot}com**.

View File

@ -1,2 +1,3 @@
scapy scapy-python3
python-nmap python-nmap
netifaces

18
scan.py
View File

@ -1,21 +1,25 @@
#!/usr/bin/env python #!/usr/bin/env python3
# -.- coding: utf-8 -.- # -.- coding: utf-8 -.-
# scan.py # scan.py
# authors: k4m4 & xdavidhu
"""
Copyright (C) 2017-18 Nikolaos Kamarinakis (nikolaskam@gmail.com) & David Schütz (xdavid@protonmail.com)
See License at nikolaskama.me (https://nikolaskama.me/kickthemoutproject)
"""
import nmap
# perform a network scan with nmap
def scanNetwork(network): def scanNetwork(network):
# Function for performing a network scan with nmap with the help of the python-nmap module
returnlist = [] returnlist = []
import nmap
nm = nmap.PortScanner() nm = nmap.PortScanner()
a = nm.scan(hosts=network, arguments='-sP') a = nm.scan(hosts=network, arguments='-sn')
for k, v in a['scan'].iteritems(): for k, v in a['scan'].items():
if str(v['status']['state']) == 'up': if str(v['status']['state']) == 'up':
try: try:
returnlist.append([str(v['addresses']['ipv4']), str(v['addresses']['mac'])]) returnlist.append([str(v['addresses']['ipv4']), str(v['addresses']['mac'])])
except: except:
pass pass
# returnlist = hostsList array
return returnlist return returnlist

View File

@ -1,10 +1,9 @@
#!/usr/bin/env python #!/usr/bin/env python3
# -.- coding: utf-8 -.- # -.- coding: utf-8 -.-
# spoof.py # spoof.py
# authors: k4m4 & xdavidhu
""" """
Copyright (C) 2016 Nikolaos Kamarinakis (nikolaskam@gmail.com) & David Schütz (xdavid@protonmail.com) Copyright (C) 2017-18 Nikolaos Kamarinakis (nikolaskam@gmail.com) & David Schütz (xdavid@protonmail.com)
See License at nikolaskama.me (https://nikolaskama.me/kickthemoutproject) See License at nikolaskama.me (https://nikolaskama.me/kickthemoutproject)
""" """
@ -15,11 +14,15 @@ from scapy.all import (
getmacbyip, getmacbyip,
ARP, ARP,
Ether, Ether,
sendp sendp,
conf,
RadioTap,
Dot11,
Dot11Deauth
) )
# send malicious ARP packets
def sendPacket(my_mac, gateway_ip, target_ip, target_mac): def sendPacket(my_mac, gateway_ip, target_ip, target_mac):
# Function for sending the malicious ARP packets out with the specified data
ether = Ether() ether = Ether()
ether.src = my_mac ether.src = my_mac