Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/D3Ext/WEF

Wi-Fi Exploitation Framework
https://github.com/D3Ext/WEF

bash kali-linux oswp wef wifi wifi-exploitation-framework

Last synced: 24 days ago
JSON representation

Wi-Fi Exploitation Framework

Awesome Lists containing this project

README

        


WEF


WiFi Exploitation Framework


Coded with 💙 by D3Ext








Introduction •
Attacks •
Features •
Installation •
Requirements


Readme in spanish

---


WEF

## Introduction

This project started over 2021 as a personal tool to easily audit networks without writing long commands or setting all values one by one, in order to automate the whole processes. This is not a professional tool, this project was created to learn about wireless security and for testing purposes. This is a fully offensive framework to audit wifi networks with different types of attacks for WPA/WPA2, WPS and WEP, automated handshake cracking and much more.

If you find an error, please open an issue (you can write it in english or spanish, as you want). If you have any doubt contact me via Discord, my username is ***d3ext***

## Attacks

- Deauthentication attack
- WIDS Confusion attack
- Authentication attack
- Beacon Flood attack
- TKIP attack (Michael Shutdown Exploitation)
- Pixie Dust attack
- Null Pin attack
- PIN Bruteforce attack
- ARP Replay attack
- HIRTE attack
- Caffe Latte attack
- Fake Authentication attack
- WPA/WPA2 handshake capture attack (passively)
- PMKID attack
- Evil Twin attack

This attacks are explained [here](https://github.com/D3Ext/WEF/wiki/Attacks) on the Wiki

## Features

:ballot_box_with_check: WPA/WPA2, WPS and WEP Attacks

:ballot_box_with_check: Automatic handshake capture and cracking

:ballot_box_with_check: Multiple templates for EvilTwin attack (different languages)

:ballot_box_with_check: Enable/disable monitor mode and view interface info (frequencies, chipset, MAC...)

:ballot_box_with_check: 2.4 GHz and 5 GHz supported

:ballot_box_with_check: Informative attack logs (just done user side)

:ballot_box_with_check: Custom wordlist selector when cracking handshakes

:ballot_box_with_check: English and spanish supported

And much more

## Installation

> As root
```sh
git clone https://github.com/D3Ext/WEF
cd WEF
bash wef
```

Take a look at the [Wiki](https://github.com/D3Ext/WEF/wiki/Installation) where I have more info about the installation

## Uninstallation

Simply execute this:

```sh
rm -rf /usr/share/wef \
/usr/bin/wef
```

## Usage

> Common usage of the framework
```sh
wef -i wlan0 # Your interface name might be different
```

> Help panel
```
__ _____ ___
\ \ / / __| __|
\ \/\/ /| _|| _|
\_/\_/ |___|_|

[WEF] WiFi Exploitation Framework 1.4

[*] Interfaces:
wlan0
ens33

Required parameters:
-i, --interface) The name of your network adapter interface in managed mode

Optional parameters:
-h, --help) Show this help panel
--version) Print the version and exit
```

See [here](https://github.com/D3Ext/WEF/wiki/Usage-&-Tips) for more information about how to use the tool and other related topics

## Demo

## TODO

- ~~Pwnagotchi mode~~
- Add vendor logo to EvilTwin templates on the fly
- Test compatibility with others OS
- ~~KARMA attack~~
- In-depth testing of implemented features
- ~~More general improvement~~
- ~~More languages added to Evil Twin templates~~

## Contributing

See [CONTRIBUTING.md](https://github.com/D3Ext/WEF/blob/main/CONTRIBUTING.md)

## Changelog

See [CHANGELOG.md](https://github.com/D3Ext/WEF/blob/main/CHANGELOG.md)

## Credits

Thanks to [ultrazar](https://github.com/ultrazar) and [ErKbModifier](https://github.com/ErKbModifier), they helped me a lot <3

## References

```
https://github.com/aircrack-ng/aircrack-ng
https://github.com/aircrack-ng/mdk4
https://github.com/v1s1t0r1sh3r3/airgeddon
https://github.com/FluxionNetwork/fluxion
https://github.com/P0cL4bs/wifipumpkin3
https://github.com/s0lst1c3/eaphammer
https://github.com/derv82/wifite2
https://github.com/wifiphisher/wifiphisher
https://github.com/ZerBea/hcxtools
https://github.com/ZerBea/hcxdumptool
https://github.com/Tylous/SniffAir
https://github.com/evilsocket/pwnagotchi
https://github.com/koutto/pi-pwnbox-rogueap
https://github.com/koutto/pi-pwnbox-rogueap/wiki/01.-WiFi-Basics
```

## Disclaimer

Creator has no responsibility for any kind of:

- Illegal use of the project.
- Law infringement by third parties and users.
- Malicious act, capable of causing damage to third parties, promoted by the user through this software.

## License

This project is under MIT license

Copyright © 2024, *D3Ext*