DeauthNet - DeauthNet is a versatile software designed to perf

项目说明

DeauthNet

Disclaimer

This software can potentially be used for malicious and unethical purposes. Therefore, I, Pietro , the author of DeauthNet and owner of this repository, assume no responsibility for any improper or harmful use of this software. This tool has been de exclusively for ethical purposes and any usage that these principles is neither supported nor endorsed.

Software Description

DeauthNet is a software designed and de entirely by the owner of this repository, Pietro , as master’s thesis project in Computer Science at the Uni of Sannio in Benevento, within the scope of Security of Networks and Software Systems. It has been de to perform de-authentication attacks, in order to demonstrate how easily such an attack can be executed and to provide tools for detecting and blocking this kind of attacks on the machine where the software is running, making it a comprehensi for e and identifying de-authentication attacks on Wi-Fi networks.

Credits

DeauthNet relies on the following python packages:
- Scapy: De by Philippe Biondi, Scapy is a powerful Python library used for packet manipulation and network analysis.
- Sortedcontainers: Created by Grant Jenks, this library provides fast and efficient sorted collections.
- Rich: De by Will McGugan, Rich is a library for rendering rich text and ad formatting in the terminal.

Getting Started

Dependencies

- A Linux distribution (Ubuntu, Debian, etc)

A wireless network adapter that supports monitor mode (if the Linux distribution is running on a machine, you need to use an external wireless network adapter)

- Python 3.10 or higher

#### Linux System Dependencies
- net-tools
- wireless-tools
- ebtables

To install these dependencies, execute the following commands in your terminal:

sudo apt-get update
sudo apt-get install -y net-tools wireless-tools ebtables

#### Python Packages
- scapy >= 2.5.0
- sortedcontainers >= 2.4.0
- rich >= 13.7.1

To install these dependencies, from the project root directory, open your terminal and execute the following command:

pip install -r requirements.txt

Usage

Initial Setup

Before utilizing any of the three primary functionalities, an initial scan of nearby access points must be conducted, facilitated through the software’s scanning feature utilizing Scapy. Users can customize the scanning process by modifying the /Core/WiFiBandManager/wifi_band_manager_settings.json file, that specifies the frequency bands to scan. This customization allows to scan for specific frequency bands, on which subsequently the attacking, detection and blocking functionalities of the software will focus. This approach ensures flexibility in e and mitigating potential across desired network frequencies.

Main Features

DeauthNet provides three primary functionalities, besides the access point scan:
1. De-authentication Attack: This feature allows the execution of de-authentication attacks.
2. Attack Detection: This feature detects de-authentication attacks using a sliding time window to monitor the number of de-authentication packets associated with a particular access point.
3. Attack Blocking: An extension of the detection feature, this functionality not only detects but also blocks attacks, by blacklisting the attacked access points.

Attack Mechanism

The attack mechanism of DeauthNet is designed to disrupt network connectivity by forcing clients to disconnect from access points. When initiating an attack, user can select one or more access points, but DeauthNet also extends its impact to every access point within the same mesh network of the attacked ones, showing how easy is to affect an entire mesh network’s integrity. Once one or more target are chosen, the software continuously sends de-authentication packets across all associated frequencies, such as both 2.4 GHz and 5 GHz bands, simultaneously disrupting their connectivity. It’s crucial to emphasize that DeauthNet is intended for ethical purposes only, such as educational or research contexts and any unauthorized or malicious use of this tool is explicitly disclaimed and unsupported by the author.

Detection Mechanism

The detection mechanism relies on a time window to count the number of de-authentication packets associated with a specific access point within that window. Packets outside the window are discarded. If the number of packets exceeds a certain threshold, as defined in a project file, an attack is assumed to be in progress, and the detection functionality notifies the user.

Blocking Mechanism

The blocking feature extends the detection functionality by adding the ability to blacklist an access point when an attack is detected.

License

This software is released under the GPL-3 license, which allows for its use, modification and distribution according to the terms of this license. In compliance with the GPL-3 license, any distribution or modification of this software must gi to Pietro , the original author.

项目信息

开发语言：Python

Star 数：10

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕DeauthNet is a versatile software designed to perform de-authentication attacks across multiple and configurable frequency bands (the default ones are 2.4 & 5 GHz). It also provides capabilities to detect and block ongoing attacks, offering comprehensive solutions to safeguard Wi-Fi networks against the de-authentication threats.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。