Detecção de pacotes usando o Extcap

Ver código-fonte no GitHub

Este guia aborda como configurar o extcap para que o Wireshark detecte pacotes de uma rede Thread.

Para usar o Pyspinel para detectar pacotes sem o extcap, consulte Como detectar pacotes com o Pyspinel.

Configurar o ambiente do sniffer

Antes de começar, siga estas etapas:

Verificação

Este guia foi verificado com o Zolertia Firefly (SoC CC2538 da Texas Instruments) nos seguintes sistemas host:

  • Debian 4.19.37 — Wireshark 3.0.4
  • macOS Mojave 10.14.6 — Wireshark 3.0.5
  • Windows 10 de 64 bits, versão 17134 — Wireshark 3.0.6

Criar e atualizar o sniffer

As instruções de build e flash variam de acordo com a plataforma.

Para instruções sobre como criar e atualizar o CC2538, consulte o README do exemplo do CC2538 (link em inglês) no GitHub.

Para instruções gerais de build, consulte Como criar o OpenThread.

Usar o sniffer

A tela de captura do Wireshark aparece quando ele é iniciado pela primeira vez. Ele deve listar as interfaces de hardware conectadas a um sniffer do OpenThread.

Capturar de uma única interface

Se esta é sua primeira vez usando uma interface, clique no botão Opções à esquerda dela:

OT Sniffer Wireshark Extcap Capture

  1. Defina o Canal como o valor desejado.
  2. Verifique o IEEE 802.15.4 TAP para garantir que as informações do canal sejam incluídas na saída pcap e possam ser exibidas na GUI do Wireshark.
  3. Marque Salvar parâmetros no início da captura para garantir que esses parâmetros sejam salvos após o início da captura, evitando que você precise definir novamente na próxima vez que usar a interface (a menos que precise mudar o canal).
  4. Clique em Iniciar.

Opções de Extcap do Wireshark do OT Sniffer

Se os parâmetros já estiverem salvos, comece a detectar selecionando a interface de hardware e clicando no ícone do Wireshark no canto superior esquerdo.

Capturar de várias interfaces

Selecione todas as interfaces de hardware listadas na tela de captura e clique no ícone do Wireshark no canto superior esquerdo.

Use estes campos para identificar sniffers individuais ao capturar de várias interfaces:

  • ID da interface (frame.interface_id): identificador da interface usado pelo Wireshark para identificar uma interface de captura.
  • Nome da interface (frame.interface_name): nome da interface usado pelo Wireshark para identificar uma interface de captura.
  • Canal (wpan-tap.ch_num): canal de captura IEEE 802.15.4 (intervalo: 11 a 26).

OT Sniffer Wireshark Extcap Packets

Solução de problemas

O sniffer do OpenThread não é listado como uma interface do Wireshark.

  1. Se você tiver vários intérpretes do Python instalados, verifique se o interpretador do Python 3 é usado pelo script extcap. O Pyspinel não é compatível com o Python 2.
  2. Verifique se o hardware é enumerado no USB e se os drivers são carregados.
  3. Verifique se o firmware correto (NCP ou RCP) foi transferido para o hardware.
  4. Verifique se o script Python localizado no caminho extcap é executável.
    • Para OS X e Linux:
      1. Verifique se a permissão de execução está presente no arquivo extcap_ot.py: 
        ls -l extcap_ot.py
      2. Se a permissão de execução (x) estiver ausente, modifique as permissões: 
        chmod +x extcap_ot.py
      3. Verifique se a interface está listada: 
        extcap_ot.py --extcap-interfaces
    • No Windows:
      1. Verifique se a interface está listada: 
        extcap_ot.bat --extcap-interfaces
      2. Se isso sair com um erro do Python, verifique se a versão do Python é 3.x: 
        py -3 --version

O Wireshark só permite que o usuário root capture pacotes

Durante a instalação do Wireshark no Ubuntu, o usuário vai precisar escolher uma das seguintes opções:

  1. Crie o grupo de usuários wireshark e permita que todos os membros desse grupo capturam pacotes.
  2. Permitir que apenas o usuário root capture pacotes.

Não é recomendável usar o Wireshark como usuário root. Se você escolheu essa opção, mude a configuração:

sudo dpkg-reconfigure wireshark-common

Se o Wireshark tiver sido configurado para restringir a captura a membros do grupo wireshark, talvez seja necessário adicionar o usuário correto ao grupo:

sudo usermod -a -G wireshark user

Adicione também o usuário correto ao grupo dialout:

sudo usermod -a -G dialout user

Feche e reinicie o Wireshark para aplicar as novas configurações do grupo de usuários.

Erro de formato do Wireshark ao capturar em várias interfaces USB no Windows

Esse é um problema conhecido em algumas versões mais antigas do Wireshark. Verifique se você está usando o Wireshark 3.0.6 ou mais recente.