amibhai/spoofedEine professionelle, vollständig asynchrone Python-Netzwerk-Spoofing-Suite für autorisierte Sicherheitsaudits. Bietet vollständige IPv4/IPv6-Interception, 802.11-Wireless-Angriffe, LLMNR/NBT-NS-Poisoning und eine interaktive TUI mit manipulationssicherem Audit-Logging.
Professionelle asynchrone Python-Netzwerk-Spoofing-Suite Interaktive menügesteuerte UI · Vollständige IPv4/IPv6-Abdeckung · Poisoning im Responder-Stil Nur für autorisierte Sicherheitstests — von amibhai
Haftungsausschluss: Dieses Tool dient ausschließlich Bildungszwecken und autorisierten Sicherheitsaudits. Die Autoren übernehmen keine Haftung und sind nicht verantwortlich für jeglichen Missbrauch oder Schaden, der durch dieses Programm verursacht wird. Verwenden Sie dieses Tool nicht in Netzwerken, die Ihnen nicht gehören oder für die Sie keine ausdrückliche schriftliche Genehmigung zum Testen haben.
| Modul | Beschreibung |
|---|---|
attacks/deauth.py | 802.11-Deauthentifizierung — Clients trennen, WPA-Handshakes erfassen |
attacks/beacon_flood.py | 802.11-Beacon-Flood — Sturm gefälschter SSIDs |
attacks/llmnr_nbt.py | LLMNR- + NBT-NS- + mDNS-Poisoning (Hash-Erfassung im Responder-Stil) |
attacks/icmpv6_ra.py | ICMPv6-Router-Advertisement-Spoofing — IPv6-Gateway-Hijacking |
attacks/ndp_spoof.py | IPv6-NDP-Neighbor-Advertisement-Poisoning — IPv6-ARP-Spoofing |
attacks/captive_portal.py | Captive Portal (Vorlagen für Hotel/Unternehmen/Café/ISP) |
attacks/wpad.py | WPAD-Proxy-Auto-Config-Injection |
core/platform_compat.py | Abstraktion für macOS pf + Linux iptables + Windows netsh |
| Timing-Jitter | Zufällige Verzögerung von ±N Sekunden bei jedem Paket-Burst zur IDS-Umgehung |
| GitHub Actions CI | pytest + mypy + Coverage-Gate (≥80 %) über Python 3.10–3.12 |
| Docker | docker build + docker-compose up für portable Bereitstellung |
| pyproject.toml | Modernes Packaging, mypy-Strict-Konfiguration, ruff-Lint, Coverage-Konfiguration |
| Funktion | Details |
|---|---|
| Autorisierung | Scope-Datei für Rules of Engagement — Live-Einsatz wird für jedes Ziel außerhalb des Geltungsbereichs oder außerhalb des Zeitfensters verweigert; kein Scope ⇒ nur Dry-Run |
| Architektur | 100 % asynchrones Python 3.10+ — kein threading.Thread |
| UI | Animiertes 256-Farben-Banner + nummerierte Menüs + Breadcrumbs |
| Dashboard | PRISM-Live-TUI mit 3 Panels (Angriffsprotokoll / Paketstatistiken / Anmeldedaten) |
| Protokollierung | HMAC-SHA256-verketteter structlog-Audit-Trail (manipulationssicher) |
| Berichte | Automatisch generierte JSON- + Markdown- + HTML-Berichte nach jeder Sitzung |
| Sprachen | Automatische Erkennung über LANG + manuelles Umschalten (en, hi, ar, zh, fr, es) |
| Preflight | 17-Punkte-Systemprüfung (Scope, Root, Python, Abhängigkeiten, Schnittstellen, Terminal) |
| Bereinigung | Stellt ARP/NDP-Tabellen sowie iptables/pf-Regeln immer in finally wieder her |
| Plattform | Linux (vollständig) · macOS (pf-Backend) · Windows (Npcap, eingeschränkt) |
Reale Einsätze werden durch einen signierten Scope definiert. Diese Toolkit erzwingt einen solchen im Code: Es wird kein einziges Paket an ein Ziel gesendet, das nicht ausdrücklich autorisiert ist und sich innerhalb eines offenen Einsatzfensters befindet. Das ist der Unterschied zwischen einem professionellen Red-Team-Instrument und einem wahllosen Skript.
rules/engagement.example.json.SPOOF_TOOLKIT_SCOPE darauf.Session.guard(...) auf, bevor es ein Ziel anspricht. Ein
Ziel außerhalb der autorisierten Bereiche — oder ein abgelaufenes Einsatzfenster
— löst einen AuthorizationError aus und der Angriff wird verweigert.fingerprint — wird
in das HMAC-verkettete Audit-Log und jeden Sitzungsbericht geschrieben, sodass der Bericht
genau belegt, was autorisiert war.# 1. Copy and edit the template with your engagement details + authorized targets
cp rules/engagement.example.json rules/my-engagement.json
# 2. Point the toolkit at it (enables live fire for in-scope targets only)
export SPOOF_TOOLKIT_SCOPE=rules/my-engagement.json
# 3. Verify it loaded and the window is open
sudo -E python3 spoof_toolkit.py --preflight
| Feld | Bedeutung |
|---|---|
engagement_id | erforderlich — eindeutige Engagement-Kennung |
authorized_by | erforderlich — benannte Partei, die den Test autorisiert (SOW / Ticket) |
client, operator, contact, notes | Engagement-Metadaten für den Audit-Trail |
start, end | ISO-8601-Zeitfenster (UTC angenommen, wenn kein Offset angegeben); beide Grenzen können für offene Laufzeit weggelassen werden |
authorized_networks | IPv4/IPv6-CIDRs oder einzelne Hosts, die angegriffen werden dürfen |
authorized_macs / authorized_ssids / authorized_bssids | Allowlists für L2- / Wireless-Ziele |
denied_networks / denied_macs | No-Strike-Listen — überschreiben immer die Allowlists |
Fail-closed by design: Eine leere Allowlist autorisiert nichts, und ein
Host im Bereich eines denied_networks-Eintrags (z. B. ein Domain Controller innerhalb eines
ansonsten autorisierten /24) wird abgelehnt.
Safe Mode.
session.safe_mode = Trueerzwingt einen Dry-Run selbst bei geladenem gültigem Scope — verwenden Sie dies, um ein Engagement Ende-zu-Ende zu proben, ohne zu senden.
| Modul | Datei | Beschreibung |
|---|---|---|
| ARP Spoofing | attacks/arp_spoof.py | Cache Poisoning — MitM, DoS, einseitig, nur Gateway |
| DNS Spoofing | attacks/dns_spoof.py | Response Injection — selektiv, Spoof-All, Rules-Datei, NXDOMAIN |
| Kombiniertes MitM | attacks/combined_mitm.py | Vollständiges ARP + DNS + Credential Capture (asyncio.TaskGroup) |
| SSL Strip | attacks/ssl_strip.py | Transparenter HTTPS-Downgrade-Proxy (Linux/macOS) |
| Rogue DHCP | attacks/rogue_dhcp.py | Hijack des Standard-Gateways über einen gefälschten DHCP-Server (stealthy) |
| LLMNR/NBT-NS | attacks/llmnr_nbt.py | NEU — LLMNR + NBT-NS + mDNS Poisoning, NTLMv2-Hash-Capture |
| WPAD | attacks/wpad.py | NEU — Injection der Browser-Proxy-Autokonfiguration |
| Captive Portal | attacks/captive_portal.py | NEU — Gefälschte Login-Seite mit 4 Vorlagen |
| Modul | Datei | Beschreibung |
|---|---|---|
| Deauth | attacks/deauth.py | NEU — 802.11-Deauthentifizierung (gezielt + Broadcast), WPA-Handshake-Capture |
| Beacon Flood | attacks/beacon_flood.py | NEU — Überflutung der Funkwellen mit Hunderten gefälschter SSIDs |
| AP Scanner | attacks/deauth.py | NEU — Passiver 802.11-Beacon-Scanner |
| Client Scanner | attacks/deauth.py | NEU — Erkennung von Clients, die einem AP zugeordnet sind |