diff --git a/Cargo.lock b/Cargo.lock index 75b6866..8f3bcf2 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -69,7 +69,7 @@ checksum = "4b46cbb362ab8752921c97e041f5e366ee6297bd428a31275b9fcf1e380f7299" [[package]] name = "angry_oxide" -version = "0.7.3" +version = "0.7.4" dependencies = [ "anyhow", "byteorder", diff --git a/Cargo.toml b/Cargo.toml index cd8956a..0c57bd3 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -2,9 +2,9 @@ members = ["libs/libwifi", "libs/libwifi_macros", "libs/pcap-file"] [workspace.package] -version = "0.7.3" +version = "0.7.4" authors = ["Ryan Butler"] -description = "80211 Attack Platform" +description = "80211 Attack Tool" license = "MIT" edition = "2021" rust-version = "1.62" diff --git a/README.md b/README.md index d5ae808..51f9280 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,8 @@ AngryOxide was developed as a way to learn Rust, netlink, kernel sockets, and WiFi exploitation all at once. +You can get information about how to use the tool in the [User Guide](https://github.com/Ragnt/AngryOxide/wiki/User-Guide). + NOTE: This project is under HEAVY development and you can expect a very fast release cycle. The overall goal of this tool is to provide a single-interface survey capability with advanced automated attacks that result in valid hashlines you can crack with [Hashcat](https://hashcat.net/hashcat/). @@ -18,14 +20,13 @@ This tool is heavily inspired by [hcxdumptool](https://github.com/ZerBea/hcxdump You can download pre-compiled binaries of AngryOxide in the [releases](https://github.com/Ragnt/AngryOxide/releases/latest). -More architectures will be added as I confirm there is no endianess-related issues associated with them. - You can get information about how to use the tool in the [User Guide](https://github.com/Ragnt/AngryOxide/wiki/User-Guide). ## Features - Active state-based attack engine used to retrieve relevent EAPOL messages from Access Points and clients. - Target option that accepts MAC (aabbcc..., aa:bb:cc...) and SSID "Test_SSID" to limit attack scope. +- Whitelist option to protect specific networks from attacks. Useful if not using targets. - Auto Hunt capability to find all target channels and hop between them. - A Terminal-UI that presents all relevent data while still living in the terminal for easy usage over SSH. - Limits DEAUTHENTICATION frames that can cause more damage than good to the authentication sequence. @@ -54,7 +55,7 @@ All of these attacks are rate-controlled both to prevent erroneous EAPOL timer r ## Help ```bash -❯ sudo angryoxide --help +❯ angryoxide --help Does awesome things... with wifi. Usage: angryoxide [OPTIONS] --interface @@ -64,6 +65,7 @@ Options: -c, --channel Optional - Channel to scan. Will use "-c 1 -c 6 -c 11" if none specified -b, --band Optional - Entire band to scan - will include all channels interface can support -t, --target Optional - Target (MAC or SSID) to attack - will attack everything if none specified + -w, --whitelist Optional - Whitelist (MAC or SSID) to NOT attack -o, --output Optional - Output filename -r, --rogue Optional - Tx MAC for rogue-based attacks - will randomize if excluded --gpsd Optional - Alter default HOST:Port for GPSD connection [default: 127.0.0.1:2947]