IPv6Tools

Il framework IPv6Tools è un robusto insieme di moduli e plugin che permette a un utente di eseguire audit su una rete abilitata IPv6. I moduli integrati supportano l'enumerazione di funzionalità IPv6 come ICMPv6 e Multicast Listener Discovery (MLD). Inoltre, il framework supporta anche l'enumerazione di protocolli di livello superiore (ULP) come multicast DNS (mDNS) e Link-Local Multicast Name Resolution (LLMNR). Gli utenti possono facilmente espandere le capacità del framework creando plugin e moduli in linguaggio Python.

Approfondimento

Per leggere ulteriori informazioni su come questo progetto è nato e su come creare un'app usando le stesse tecnologie, segui i link qui sotto!

• There’s No Place Like ::1 — Enumerating Local IPv6 networks
• Per contenuti relativi a sviluppo, sicurezza, devops, AI, ecc... visita SecDevOps.AI!

• Requisiti
• Installazione
• Utilizzo
• Moduli
• Problemi noti

Requisiti

• python 2.7
• pip
• npm [solo sviluppo]

Installazione

Standard

[Opzionale] Usa un virtualenv per l'installazione: virtualenv venv && source venv/bin/activate

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

Sviluppo

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

Utilizzo

Standard

1. sudo python app.py
2. Naviga su http://localhost:8080 in un browser web

Sviluppo

1. Esegui $ npm run serve
2. In un terminale separato, esegui npm run dev
3. Naviga su http://localhost:8081 in un browser web

CLI

TODO

Moduli

I moduli sono classi che consentono l'interazione con singoli nodi o con tutti i nodi. Questi appaiono come opzione del click destro su ogni nodo, o come pulsante sotto il grafico.

Moduli inclusi

Nel progetto sono inclusi un paio di moduli per aiutare a validare la rete, oltre a fungere da esempio per i tuoi moduli.

• poisonLLMNR - Link-Local Multicast Name Resolution è il successore di NBT-NS, che permette ai nodi locali di risolvere nomi e indirizzi IP. Abilitando questo modulo si avvelenano le query LLMNR verso tutti i nodi sul collegamento locale.
• CVE-2016-1879 - La seguente CVE è una vulnerabilità in SCTP che colpisce FreeBSD 9.3, 10.1 e 10.2. Abilitando questo modulo verrà lanciato un pacchetto ICMPv6 modificato che potrebbe causare un DoS (failure di asserzione o dereferenza di puntatore nullo e kernel panic) su un singolo nodo.

Moduli personalizzati

Tutti i moduli si trovano in /modules e vengono caricati automaticamente all'avvio del server. In /modules è incluso un file chiamato template.py. Questo file contiene la classe che tutti i moduli devono estendere per essere visualizzati correttamente e comunicare con la pagina web.

Usa questo template per creare un modulo personalizzato

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)

Problemi noti

• Non testato su reti di grandi dimensioni
• Eventuali stack trace che menzionano dnet o dumbnet - segui le istruzioni qui sotto.
• Alcuni sistemi operativi potrebbero richiedere gli header di libpcap. Vedi le note seguenti.

Installazione di libdnet

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

Header libpcap su Ubuntu

sudo apt install libpcap-dev