IPv6Tools

Le framework IPv6Tools est un ensemble robuste de modules et de plugins permettant à un utilisateur d'auditer un réseau compatible IPv6. Les modules intégrés prennent en charge l'énumération des fonctionnalités IPv6 telles que ICMPv6 et la découverte des écouteurs multicast (MLD). De plus, le framework supporte également l'énumération des protocoles de couche supérieure (ULP) tels que le DNS multicast (mDNS) et la résolution de noms multicast locaux (LLMNR). Les utilisateurs peuvent facilement étendre les capacités du framework en créant des plugins et des modules en langage Python.

Article

Pour en savoir plus sur la genèse de ce projet et sur la façon de construire une application en utilisant les mêmes technologies, suivez les liens ci-dessous !

• Il n'y a pas d'endroit comme ::1 — Énumération des réseaux IPv6 locaux
• Pour du contenu lié au développement, à la sécurité, au devops, à l'IA, etc... consultez SecDevOps.AI!

• Prérequis
• Installation
• Utilisation
• Modules
• Problèmes connus

Prérequis

• python 2.7
• pip
• npm [développement uniquement]

Installation

Standard

[Optionnel] Utiliser un environnement virtuel pour l'installation : virtualenv venv && source venv/bin/activate

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

Développement

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

Utilisation

Standard

1. sudo python app.py
2. Naviguez vers http://localhost:8080 dans un navigateur web

Développement

1. Exécutez $ npm run serve
2. Dans un terminal séparé, exécutez npm run dev
3. Naviguez vers http://localhost:8081 dans un navigateur web

CLI

TODO

Modules

Les modules sont des classes qui permettent d'interagir avec des nœuds individuels ou tous les nœuds. Ils apparaissent comme une option de clic droit sur chaque nœud, ou comme un bouton sous le graphe.

Modules inclus

Le projet comprend quelques modules pour vous aider à valider votre réseau, ainsi que pour servir d'exemples pour vos propres modules.

• poisonLLMNR - La résolution de noms multicast locaux (LLMNR) est le successeur de NBT-NS, qui permet aux nœuds locaux de résoudre des noms et des adresses IP. L'activation de ce module empoisonne les requêtes LLMNR vers tous les nœuds du lien local.
• CVE-2016-1879 - Cette CVE est une vulnérabilité dans SCTP qui affecte FreeBSD 9.3, 10.1 et 10.2. L'activation de ce module envoie un paquet ICMPv6 falsifié et peut provoquer un DoS (échec d'assertion ou déréférencement de pointeur NULL et panique du noyau) sur un seul nœud.

Modules personnalisés

Tous les modules se trouvent dans /modules et sont chargés automatiquement au démarrage du serveur. Le fichier template.py est inclus dans /modules. Ce fichier contient la classe que tous les modules doivent étendre pour s'afficher correctement et communiquer avec la page web.

Utilisez ce modèle pour créer un module personnalisé

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)

Problèmes connus

• Non testé sur de grands réseaux
• Toute trace de pile mentionnant dnet ou dumbnet - suivez les instructions ci-dessous.
• Certains systèmes d'exploitation peuvent nécessiter les en-têtes libpcap. Voir les remarques ci-dessous.

Installation de libdnet

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

En-têtes libpcap sous Ubuntu

sudo apt install libpcap-dev