IPv6Tools

O framework IPv6Tools é um conjunto robusto de módulos e plugins que permitem a um usuário auditar uma rede habilitada para IPv6. Os módulos integrados suportam enumeração de funcionalidades IPv6 como ICMPv6 e Multicast Listener Discovery (MLD). Além disso, o framework também suporta enumeração de protocolos de camada superior (ULP) como multicast DNS (mDNS) e Link-Local Multicast Name Resolution (LLMNR). Usuários podem expandir facilmente a capacidade do framework criando plugins e módulos na linguagem Python.

Artigo

Para ler mais sobre como este projeto foi concretizado e como construir um aplicativo usando as mesmas tecnologias, siga os links abaixo!

• Não há lugar como ::1 — Enumerando redes IPv6 locais
• Para conteúdo relacionado a desenvolvimento, segurança, devops, IA, etc... confira SecDevOps.AI!

• Requisitos
• Instalação
• Uso
• Módulos
• Problemas Conhecidos

Requisitos

• python 2.7
• pip
• npm [apenas desenvolvimento]

Instalação

Padrão

[Opcional] Use um virtualenv para instalação: virtualenv venv && source venv/bin/activate

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

Desenvolvimento

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

Uso

Padrão

1. sudo python app.py
2. Navegue para http://localhost:8080 em um navegador web

Desenvolvimento

1. Execute $ npm run serve
2. Em um terminal separado, execute npm run dev
3. Navegue para http://localhost:8081 em um navegador web

CLI

TODO

Módulos

Módulos são classes que permitem interação com nós individuais ou todos os nós. Eles aparecem como uma opção de clique com o botão direito em cada nó, ou como um botão abaixo do gráfico.

Módulos Inclusos

Incluídos no projeto estão alguns módulos para ajudar a validar sua rede, bem como servir de exemplos para seus próprios módulos.

• poisonLLMNR - Link-Local Multicast Name Resolution é o sucessor do NBT-NS, que permite que nós locais resolvam nomes e endereços IP. Ativar este módulo envenena consultas LLMNR para todos os nós no link local.
• CVE-2016-1879 - A seguinte CVE é uma vulnerabilidade no SCTP que afeta FreeBSD 9.3, 10.1 e 10.2. Ativar este módulo lança um pacote ICMPv6 manipulado e potencialmente causa um DoS (falha de asserção ou desreferenciamento de ponteiro NULL e pânico do kernel) em um único nó.

Módulos Personalizados

Todos os módulos estão localizados em /modules e são carregados automaticamente ao iniciar o servidor. Incluído em /modules está um arquivo chamado template.py. Este arquivo contém a classe que todos os módulos devem estender para exibir corretamente e se comunicar com a página web.

Use este template para construir um 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 Conhecidos

• Não testado em redes grandes
• Quaisquer stack traces mencionando dnet ou dumbnet - siga as instruções abaixo.
• Alguns sistemas operacionais podem exigir os cabeçalhos libpcap. Veja notas abaixo.

Instalando libdnet

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

Cabeçalhos libpcap no Ubuntu

sudo apt install libpcap-dev