IPv6Tools : A Robust Modular Framework

The IPv6Tools framework is a robust set of modules and plugins that allow a user to audit an IPv6 enabled network. The built-in modules support enumeration of IPv6 features such as ICMPv6 and Multicast Listener Discovery (MLD).

In addition, the framework also supports enumeration of Upper Layer Protocols (ULP) such as multicast DNS (mDNS) and Link-Local Multicast Name Resolution (LLMNR). Users can easily expand the capability of the framework by creating plugins and modules in the Python language.

Write-UP

To read more about how this project came to fruition and how to build an app using the same technologies, follow the links below!

Requirements

  • python 2.7
  • pip
  • npm [development only]

Also Read – GDA Android Reversing Tool

Installation

Standard

[Optional] Use a virtualenv for installation: virtualenv venv && source venv/bin/activate

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

Development

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

Usage

Standard

  1. sudo python app.py
  2. Navigate to http://localhost:8080 in a web browser

Development

  1. Run $ npm run serve
  2. In a separate terminal, run npm run dev
  3. Navigate to http://localhost:8081 in a web browser

Modules

Modules are classes that allow interaction with individual nodes or all nodes. These show up as a right click option on each node, or as a button below the graph.

Included Modules

Included in the project are a couple of modules to help validate your network, as well as use as examples for your own modules.

  • poisonLLMNR – Link-Local Multicast Name Resolution is the successor of of NBT-NS, which allows local nodes to resolve names and IP addresses. Enabling this module poisons LLMNR queries to all nodes on the local link.
  • CVE-2016-1879 – The following CVE is a vulnerability in SCTP that affects FreeBSD 9.3, 10.1 and 10.2. Enabling this module will launch a crafted ICMPv6 packet and potentially cause a DoS (assertion failure or NULL pointer dereference and kernel panic) to a single node.

Custom Modules

All modules are located in /modules and are automatically loaded when starting the server. Included in /modules is a file called template.py. This file contains the class that all modules must extend in order to display correctly and communicate with the webpage.

Use this template to build a custom module

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)

Known Issues

  • Untested on large networks
  • Any stack traces mentioning dnet or dumbnet – follow the instructions below.
  • Some operating systems may require the libpcap headers. See notes below.

Installing libdnet

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

libpcap headers in Ubuntu

sudo apt install libpcap-dev

R K

Recent Posts

WhatsMyName App – Find Anyone Across 640+ Platforms

Overview WhatsMyName is a free, community-driven OSINT tool designed to identify where a username exists…

3 days ago

Analyzing Directory Size Linux Tools Explained

Managing disk usage is a crucial task for Linux users and administrators alike. Understanding which…

3 days ago

Understanding Disk Usage with du Command

Efficient disk space management is vital in Linux, especially for system administrators who manage servers…

3 days ago

How to Check Directory Size in Linux

Knowing how to check directory sizes in Linux is essential for managing disk space and…

3 days ago

Essential Commands for Linux User Listing

Managing user accounts is a core responsibility for any Linux administrator. Whether you’re securing a…

3 days ago

Command-Line Techniques for Listing Linux Users

Linux offers powerful command-line tools for system administrators to view and manage user accounts. Knowing…

4 days ago