IPv6Tools

Das IPv6Tools-Framework ist eine robuste Sammlung von Modulen und Plugins, die es einem Benutzer ermöglicht, ein IPv6-fähiges Netzwerk zu auditieren. Die integrierten Module unterstützen die Aufzählung von IPv6-Funktionen wie ICMPv6 und Multicast Listener Discovery (MLD). Darüber hinaus unterstützt das Framework auch die Aufzählung von Upper-Layer-Protokollen (ULP) wie Multicast DNS (mDNS) und Link-Local Multicast Name Resolution (LLMNR). Benutzer können die Funktionalität des Frameworks leicht erweitern, indem sie Plugins und Module in der Python-Sprache erstellen.

Write-up

Um mehr darüber zu erfahren, wie dieses Projekt zustande kam und wie man eine App mit denselben Technologien erstellt, folgen Sie den untenstehenden Links!

• There’s No Place Like ::1 — Enumerating Local IPv6 networks
• Für Inhalte zu Entwicklung, Sicherheit, DevOps, KI usw. besuchen Sie SecDevOps.AI!

• Anforderungen
• Installation
• Verwendung
• Module
• Bekannte Probleme

Anforderungen

• python 2.7
• pip
• npm [nur Entwicklung]

Installation

Standard

[Optional] Verwenden Sie eine virtualenv für die Installation: virtualenv venv && source venv/bin/activate

1. git clone http://github.com/apg-intel/ipv6tools.git
2. sudo pip install -r requirements.txt

Entwicklung

1. git clone http://github.com/apg-intel/ipv6tools.git
2. git checkout dev
3. npm run setup

Verwendung

Standard

1. sudo python app.py
2. Navigieren Sie zu http://localhost:8080 in einem Webbrowser

Entwicklung

1. Führen Sie $ npm run serve aus
2. Führen Sie in einem separaten Terminal npm run dev aus
3. Navigieren Sie zu http://localhost:8081 in einem Webbrowser

CLI

TODO

Module

Module sind Klassen, die die Interaktion mit einzelnen Knoten oder allen Knoten ermöglichen. Diese erscheinen als Rechtsklick-Option auf jedem Knoten oder als Schaltfläche unter dem Graphen.

Enthaltene Module

Im Projekt sind einige Module enthalten, die bei der Überprüfung Ihres Netzwerks helfen und als Beispiele für eigene Module dienen.

• poisonLLMNR - Link-Local Multicast Name Resolution ist der Nachfolger von NBT-NS, der es lokalen Knoten ermöglicht, Namen und IP-Adressen aufzulösen. Wenn dieses Modul aktiviert wird, werden LLMNR-Abfragen an alle Knoten im lokalen Link vergiftet.
• CVE-2016-1879 - Die folgende CVE ist eine Schwachstelle in SCTP, die FreeBSD 9.3, 10.1 und 10.2 betrifft. Wenn dieses Modul aktiviert wird, wird ein manipuliertes ICMPv6-Paket gesendet, das potenziell einen DoS (Assertionsfehler oder NULL-Pointer-Dereferenzierung und Kernel-Panik) bei einem einzelnen Knoten verursachen kann.

Benutzerdefinierte Module

Alle Module befinden sich in /modules und werden beim Starten des Servers automatisch geladen. In /modules befindet sich eine Datei namens template.py. Diese Datei enthält die Klasse, die alle Module erweitern müssen, um korrekt angezeigt zu werden und mit der Webseite zu kommunizieren.

Verwenden Sie diese Vorlage, um ein benutzerdefiniertes Modul zu erstellen

from template import Template

class IPv6Module(Template):

  def __init__(self, socketio, namespace):
    super(IPv6Module, self).__init__(socketio, namespace)
    self.modname = "CVE-2016-1879"
    self.menu_text = "FreeBSD IPv6 DoS"
    self.actions = [
      {
        "title": "FreeBSD IPv6 DoS", #name that's displayed on the buttons/menu
        "action": "action", #method name to call
        "target": True #set this to true to display it in the right-click menu
      }
    ]

  def action(self, target=None):
    # send a log msg
    self.socket_log('Running DoS on '+target['ip'])
    
    # do stuff, etc

    # merge results with main result set
    listOfDicts = [{ip: '::1', device_name: 'test'}]
    self.module_merge(listOfDicts)

Bekannte Probleme

• Nicht auf großen Netzwerken getestet
• Stacktraces, die dnet oder dumbnet erwähnen - befolgen Sie die untenstehenden Anweisungen.
• Einige Betriebssysteme benötigen möglicherweise die libpcap-Header. Siehe Hinweise unten.

Installieren von libdnet

git clone https://github.com/dugsong/libdnet.git
cd libdnet
./configure && make
sudo make install
cd python
python setup.py install

libpcap-Header in Ubuntu

sudo apt install libpcap-dev