Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ZeroDayArcade/RG353-WiFi-Penetration-Tool
Hacking WiFi Networks with the Anbernic RG353 line of hardware and other Retro Gaming Handhelds
https://github.com/ZeroDayArcade/RG353-WiFi-Penetration-Tool
anbernic anbernic-rg353 anbernic-rg353ps pmkid pmkid-attack python3 rg353 rg353m rg353p rg353ps rg353v rg353vs wifi-hacking wifi-hacking-script wifi-penetration-testing wifi-pentesting wpa2-cracking
Last synced: about 1 month ago
JSON representation
Hacking WiFi Networks with the Anbernic RG353 line of hardware and other Retro Gaming Handhelds
- Host: GitHub
- URL: https://github.com/ZeroDayArcade/RG353-WiFi-Penetration-Tool
- Owner: ZeroDayArcade
- License: mit
- Created: 2023-08-29T05:17:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-09-24T22:45:29.000Z (about 1 year ago)
- Last Synced: 2024-08-01T15:07:10.437Z (4 months ago)
- Topics: anbernic, anbernic-rg353, anbernic-rg353ps, pmkid, pmkid-attack, python3, rg353, rg353m, rg353p, rg353ps, rg353v, rg353vs, wifi-hacking, wifi-hacking-script, wifi-penetration-testing, wifi-pentesting, wpa2-cracking
- Language: Python
- Homepage: https://zerodayarcade.com/tutorials
- Size: 96.7 KB
- Stars: 14
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - ZeroDayArcade/RG353-WiFi-Penetration-Tool - Hacking WiFi Networks with the Anbernic RG353 line of hardware and other Retro Gaming Handhelds (Python)
README
# RG353-WiFi-Penetration-Tool
Hacking WiFi Networks with the Anbernic RG353 line of hardware and other Retro Gaming Handhelds
This repo contains modified versions of my WiFi hacking python scripts, now meant to run on Anbernic RG353 series hardware using the RG353's built in WiFi module. This code was specifically tested with the RG353PS, using the UnofficialOS operating system with the RG353P image from release 20230427. The scripts should work with UnofficialOS on other varients of the RG353 without modification assuming the same basic file structure. It can easily be modified to run on many other Linux-based Retro Handhelds that have WiFi capabilites.
Although there is no easy way to put the built-in WiFi chip into monitor mode, it is still capable of reading packets in managed mode that are necessary for PMKID attacks. This means that an RG353 running this code can capture a PMKID and potentially crack the password of a WiFi network from access points that are vulnerable to the PMKID exploit found by atom and the hashcat team in 2018.
The capture script should be run first which will extract the PMKID from the first EAPoL frame that the access point sends back to the RG353 when the RG353 attemps to connect to it with a random password. Although the random password will obviously fail to connect, the PMKID, MAC addresses, and SSID will be stored by the script in an hashcat hc22000 format hash line and saved to a file `hashline.txt`. The hash line can then be used later for an offline attack using hashcat on a more powerful computer ***OR*** the user can immediately try to crack it with the cracking script that comes with this codebase on the RG353 itself without any extra hardware.
The cracking script is more for demonstration purposes than anything, but for low hanging fruit (weak passwords) and with relatively small password lists, it can crack passwords without the user having to leave the RG353. I've added a very small sample `passlist.txt` file which can be used for testing, but you can also supply your own `passlist.txt` file containing larger and/or more sophisticated password dictionaries. This makes hacking on the go possible, and even if the password can't be cracked by the on-board script, the hash line that is saved to `hashline.txt` on the TF2 slot Micro SD card can be cracked later with more powerful cracking tools as previously mentioned.
I successfully tested this on WPA2 with a TP-Link Archer C1200 v2.0 Router (Firmware Version 2.0.0) with both 2.4Ghz and 5Ghz networks. I found capturing PMKID on 2.4Ghz to work almost 100% of the time and within a couple of seconds, whereas capturing from 5Ghz was less reliable only working ~50% of the time and often taking longer. Make sure in testing that networks are visible (not hidden). You may be able to get more reliability out of 5Ghz captures by playing around with when WiFi gets restarted on the device (see `capture.sh` and potentially move WiFi restart into `capture_pmkid.py` with `os.system`) and/or by removing timeout code in `capture_pmkid.py`. Although they are very common, only WPA/WPA2 networks that use PMKID are vulnerable to this attack.
***Reminder:** Only ever hack a network that you own and have legal permission to hack. Any hacking skills/knowledge gained from this repository should only be used within the context of security research, penetration testing, password recovery, and education.*
## Steps to using the tool
*TL;DR: Use UnofficialOS, copy "RG353-WiFi-Pen/" to "ports/" on ROMS MicroSD, run scripts from "PORTS" Menu*
1. ***Install UnofficialOS*** on your RG353P/PS/M/etc (Backup your original OS or use a seperate Micro SD in slot TF1)
2. Clone this repo and ***copy the RG353-WiFi-Pen directory*** to the "ports/" directory of the slot TF2 (Roms) MicroSD card
3. With the TF2 MicroSD back in the RG353, press the 'START' button and ***go to Network Settings*** and make sure WiFi is enabled
4. Select the target WiFi network and ***enter a random password for the network***
5. Exit the menus and ***navigate to "PORTS"*** on the main interface
6. Enter "PORTS" and ***select the "RG353-WiFi-Pen" directory***, you will see two options: ***capture*** and ***crack***
7. ***Select "capture"*** to run the PMKID capture script on you target network. If it is unable to capture PMKID it will timeout after a minute
8. If the PMKID capture was successfull you will see the PMKID, MAC addresses and SSID printed to the screen along the a hashcat format hash line which has been saved to the MicroSD card in `ports/RG353-WiFi-Pen/hashline.txt`. If the PMKID is all 0's, that likely means the access point you are targeting does not append a PMKID to the end of the first EAPol frame and is not vulnerable to this type of attack. Otherwise you're ready to crack
9. Now ***run the "crack" script*** from the same place you ran the capture script. If the password of the network is part of the `passlist.txt` dictionary, than the password will be cracked. Otherwise you can take the hash line saved to `hashline.txt` for later cracking with hashcat or other cracking tools (you won't see it from the main menu but it's on the MicroSD if you open the MicroSD on your computer).
In the example above you can see that my test network "ZDA_TP_LINK" was cracked and the password was "minecraft". If you are testing with the on board cracking script, use an 8+ character password that is in your `passlist.txt` file (Note some passwords in the sample `passlist.txt` are too short, pick one that's at least 8) to ensure that everything is working correctly.
### *See it in action:* Video
# More ZDA Code and Resources:
**Learn Reverse Engineering, Assembly, Code Injection and More:**
🎓 zerodayarcade.com/tutorials
**More WiFi Hacking with Simple Python Scripts:**
Capturing PMKID from WiFi Networks
Cracking WiFi Passwords with PMKID
Capturing 4-Way Handshake from WPA/WPA2 Networks
Cracking WPA/WPA2 Passwords with 4-Way Handshake
**More Retro Gaming Handhelds:**
Connecting a Game Boy Advance SP to the Internet
Multiplayer Quake 1 on a Nintendo DS vs PC Player: Crossplay
Tutorial - Crossplay Quake on Anbernic RG353PS vs PC