ZeroJack

Ein Tool zur Durchführung von MouseJack-Tastatureingabe-Injektionsangriffen.

⚠️ Haftungsausschluss

Das Projekt wurde zu Bildungszwecken erstellt. Ich bin nicht verantwortlich für jegliche böswillige Nutzung des Projekts und der hier bereitgestellten Informationen.

👾 Über das Projekt

Das Projekt wurde zu Bildungszwecken und als Alternative zum Crazyradio PA-Gerät erstellt, um mit den eigenen anfälligen drahtlosen Mäusen zu spielen. Es besteht aus zwei Hauptkomponenten:

• Software: ZeroJack Python3-Anwendung
• Hardware: Raspberry Pi Zero 2W und SPI-verbundenes nRF24L01+ Modul
  Raspberry Pi Zero 2W im Headless-Setup wurde gewählt, da es eine gute Plattform für ein All-in-One-Hacking-Gerät ist, das für MouseJacking, Wardriving, Bluetooth-Angriffe usw. verwendet werden kann. Es ist zum Beispiel kein Herumspielen mit Firmware-Flashen erforderlich.

Als Payload verwendet das Tool Legacy DuckyScript (1.0) Dateien.

✅ Funktionen

Die Software implementiert vier Modi:

• Hauptmodus (manuell) Scannt nach anfälligen 2,4-GHz-HID-Geräten, wählt gefundene Geräte aus und startet einen Tastatureingabe-Injektionsangriff.
• Autopwn-Modus Scannt nach anfälligen 2,4-GHz-HID-Geräten und startet automatisch einen Tastatureingabe-Injektionsangriff. DIESEN MODUS VORSICHTIG VERWENDEN!
• Zielmodus Startet einen Tastatureingabe-Injektionsangriff für ein bestimmtes Gerät, dessen Adresse durch Scannen im Hauptmodus zuvor ermittelt werden konnte.
• Sniffer-Modus Weist dem nRF-Modul eine Zielgeräteadresse zu und zeigt rohe Funkpakete an.

💾 Einrichtung und Installation

SPI aktivieren

Für RaspberryPi OS (Debian 12 Bookworm) kann dies auf zwei Arten erfolgen: über die CUI-Anwendung oder manuell.
CUI:

sudo raspi-config

dann zu Interface Options -> SPI gehen, SPI aktivieren bestätigen und neu starten.

Manuell:

sudo nano /boot/firmware/config.txt

Zeile dtparam=spi=on auskommentieren, speichern und neu starten.

Überprüfen, ob SPI aktiviert ist: ls -al /dev/*spi*. Sie sollten Geräte wie /dev/spidev0.0 sehen.

Installation der ZeroJack-Anwendung

Repository klonen:

git clone https://github.com/b1narygl1tch/zerojack.git

Virtuelle Umgebung erstellen:

python -m venv ./zerojack

Virtuelle Umgebung aktivieren:

cd ./zerojack
source bin/activate

Setup-Skript ausführen:

pip install .

Tool starten:

zerojack --help

📻 Hardware

Es werden drei Hardwarekomponenten verwendet:

• Raspberry Pi Zero 2 W
• nRF24L01-Modul (EByte E01-ML01DP5)
• AMS1117-basiertes Stromversorgungsmodul (YL-105). Optional, aber sehr empfehlenswert!

Anschlussplan für Raspberry Pi <-> YL-105 <-> nRF24L01-Variante. IRQ wird nicht verwendet.

🐭 Getestete Mausgeräte

• Logitech M325 (unifying dongle C-U0007)
• Microsoft Wireless Mouse 4000
• Amazon Basics MG-0975

👍 Danksagungen

Die folgenden Forschungen, Bibliotheken und Projekte werden in diesem Projekt verwendet:

• Bastille original research https://github.com/BastilleResearch/mousejack/blob/master/doc/pdf/MouseJack-whitepaper-v1.1.pdf
• Promiscuity is the nRF24L01+'s Duty http://travisgoodspeed.blogspot.com/2011/02/promiscuity-is-nrf24l01s-duty.html
• RaspJack-Projekt https://github.com/DigitalSecurity/raspjack
• JackIt-Projekt https://github.com/insecurityofthings/jackit
• Python-Port der RF24-Bibliothek für NRF24L01+ Funkmodule https://github.com/jpbarraca/pynrf24
• Mousejack für Arduino UNO https://github.com/dnatividade/Arduino_mousejack

📜 Lizenz

Das Projekt steht unter der BSD-3-Clause-Lizenz und basiert auf den folgenden Projekten:

• Python-Port der RF24-Bibliothek für NRF24L01+ Funkmodule https://github.com/jpbarraca/pynrf24. Steht unter GPL-2.0-Lizenz.
• JackIt-Projekt https://github.com/insecurityofthings/jackit. Steht unter BSD-Lizenz.
• RaspJack-Projekt https://github.com/DigitalSecurity/raspjack. Steht unter GPL-3.0-Lizenz.