IPv6Tools

El framework IPv6Tools es un conjunto robusto de módulos y plugins que permiten a un usuario auditar una red habilitada para IPv6. Los módulos integrados permiten la enumeración de características de IPv6 como ICMPv6 y Multicast Listener Discovery (MLD). Además, el framework también permite la enumeración de protocolos de capa superior (ULP) como multicast DNS (mDNS) y Link-Local Multicast Name Resolution (LLMNR). Los usuarios pueden ampliar fácilmente la capacidad del framework creando plugins y módulos en el lenguaje Python.

Artículo

¡Sigue los enlaces a continuación para leer más sobre cómo este proyecto se materializó y cómo construir una aplicación usando las mismas tecnologías!

• There’s No Place Like ::1 — Enumerating Local IPv6 networks
• Para contenido relacionado con desarrollo, seguridad, devops, IA, etc... visita SecDevOps.AI!

• Requisitos
• Instalación
• Uso
• Módulos
• Problemas conocidos

Requisitos

• python 2.7
• pip
• npm [solo desarrollo]

Instalación

Estándar

[Opcional] Usar un virtualenv para la instalación: virtualenv venv && source venv/bin/activate

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

Desarrollo

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

Uso

Estándar

1. sudo python app.py
2. Navegar a http://localhost:8080 en un navegador web

Desarrollo

1. Ejecutar $ npm run serve
2. En una terminal separada, ejecutar npm run dev
3. Navegar a http://localhost:8081 en un navegador web

CLI

TODO

Módulos

Los módulos son clases que permiten la interacción con nodos individuales o todos los nodos. Aparecen como una opción de clic derecho en cada nodo, o como un botón debajo del gráfico.

Módulos incluidos

En el proyecto se incluyen un par de módulos para ayudar a validar tu red, así como para usar como ejemplos para tus propios módulos.

• poisonLLMNR - Link-Local Multicast Name Resolution es el sucesor de NBT-NS, que permite a los nodos locales resolver nombres y direcciones IP. Activar este módulo envenena las consultas LLMNR a todos los nodos en el enlace local.
• CVE-2016-1879 - El siguiente CVE es una vulnerabilidad en SCTP que afecta a FreeBSD 9.3, 10.1 y 10.2. Activar este módulo lanzará un paquete ICMPv6 manipulado y potencialmente causará una denegación de servicio (fallo de aserción o desreferencia de puntero nulo y pánico del kernel) a un solo nodo.

Módulos personalizados

Todos los módulos se encuentran en /modules y se cargan automáticamente al iniciar el servidor. En /modules se incluye un archivo llamado template.py. Este archivo contiene la clase que todos los módulos deben extender para mostrarse correctamente y comunicarse con la página web.

Usa esta plantilla para construir un módulo personalizado

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)

Problemas conocidos

• No probado en redes grandes
• Cualquier traza de pila que mencione dnet o dumbnet: sigue las instrucciones a continuación.
• Algunos sistemas operativos pueden requerir los encabezados de libpcap. Consulta las notas a continuación.

Instalación de libdnet

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

Encabezados de libpcap en Ubuntu

sudo apt install libpcap-dev