killerbee

Kit de Pesquisa em Segurança IEEE 802.15.4/ZigBee

REQUISITOS

O KillerBee é desenvolvido e testado em sistemas Linux. O uso em MacOS é possível, mas não suportado.

Nós nos esforçamos para usar um número mínimo de dependências de software, no entanto, é necessário instalar os seguintes módulos Python antes da instalação. A instalação detectará e solicitará o que for necessário.

Em sistemas Ubuntu, você pode instalar as dependências necessárias com os seguintes comandos:

No Mac OS, você pode instalar as dependências com os seguintes comandos

O python-dev e o libgcrypt são necessários para o Scapy Extension Patch.

Observe também que esta é uma plataforma de ataque bastante avançada e pouco amigável. Isto não é Cain & Abel. É destinada a desenvolvedores e analistas avançados que estão atacando redes ZigBee e IEEE 802.15.4. Recomendo que você obtenha algum entendimento do protocolo ZigBee (o livro ZigBee Wireless Networks and Transceivers de Shahin Farahani é razoável, embora ainda não seja excelente) e familiaridade com a linguagem Python antes de mergulhar neste framework.

INSTALAÇÃO

O KillerBee usa o arquivo de instalação padrão 'setup.py' do Python, uma vez que as dependências estejam instaladas.

Instale o KillerBee com o seguinte comando:

DIRETÓRIOS

A estrutura de diretórios do código KillerBee é descrita a seguir:

• doc - Documentação HTML sobre a biblioteca KillerBee, cortesia do epydoc.
• firmware - Firmware para dispositivos de hardware suportados pelo KillerBee.
• killerbee - Código-fonte da biblioteca Python.
• sample - Capturas de pacotes de exemplo, referenciadas abaixo.
• scripts - Scripts Shell usados no desenvolvimento.
• tools - Ferramentas de ataque ZigBee e IEEE 802.15.4 desenvolvidas usando este framework.

HARDWARE NECESSÁRIO

O framework KillerBee está sendo expandido para suportar múltiplos dispositivos. Atualmente há suporte para River Loop ApiMote, Atmel RZ RAVEN USB Stick, MoteIV Tmote Sky, TelosB mote, Sewino Sniffer, e vários hardwares executando firmware Silicon Labs Node Test.

Veja firmware/README.md para detalhes sobre suporte de hardware e programação de firmware.

Suporte para Freaklab's Freakduino com hardware adicional e o sketch arduino de Dartmouth e placas Zigduino estão disponíveis, mas não são listados por não serem mantidos. Você deve habilitá-los para serem pesquisados em killerbee/config.py e então reinstalar o KillerBee.

FERRAMENTAS

O KillerBee inclui várias ferramentas projetadas para atacar redes ZigBee e IEEE 802.15.4 , construídas usando o framework KillerBee. Cada ferramenta tem suas próprias instruções de uso documentadas executando a ferramenta com o argumento "-h", e resumidas abaixo.

• zbid - Identifica interfaces disponíveis que podem ser usadas pelo KillerBee e ferramentas associadas.
• zbwireshark - Similar ao zbdump, mas expõe um pipe nomeado para captura em tempo real e visualização no Wireshark.
• zbdump - Uma ferramenta similar ao tcpdump para capturar quadros IEEE 802.15.4 em um arquivo libpcap ou Daintree SNA de captura de pacotes. Não exibe estatísticas em tempo real como o tcpdump quando não está gravando em um arquivo.
• zbreplay - Implementa um ataque de repetição, lendo de um arquivo de captura de pacotes Daintree DCF ou libpcap especificado, retransmitindo os quadros. Quadros ACK não são retransmitidos.
• zbstumbler - Ferramenta de descoberta ativa de redes ZigBee e IEEE 802.15.4. O Zbstumbler envia quadros de solicitação de beacon enquanto salta entre canais, registrando e exibindo informações resumidas sobre dispositivos descobertos. Também pode registrar resultados em um arquivo CSV.
• zbpanidconflictflood - Requer duas interfaces killerbee uma interface killerbee escuta pacotes e marca seu PAN ID. A outra interface envia constantemente pacotes beacon com os PAN IDs encontrados. Os pacotes beacon com o mesmo PAN ID fazem o coordenador PAN acreditar que há um conflito de PAN ID, e o coordenador inicia o processo de realinhamento da rede em um novo PAN ID. O processo se repete ad nauseum. Normalmente, os dispositivos de rede não conseguem acompanhar a mudança rápida e após alguns segundos a rede se desfaz. NENHUM ALVO EMBUTIDO: Isso pode destruir todas as redes zigbee ao alcance no canal em que você está realizando o ataque. Use com cautela.
• zborphannotify - Falsifica um pacote de notificação órfão do dispositivo alvo para um Coordenador PAN para testar o comportamento do Coordenador.
• zbrealign - Falsifica um quadro de Realinhamento PAN 802.15.4 do coordenador para um dispositivo alvo. Pode ser capaz de redefinir o PAN ID ou Canal do dispositivo.
• zbfakebeacon - Falsifica quadros beacon, seja enviando spam ou em resposta a uma solicitação de beacon recebida.
• zbopenear - Auxilia na captura de dados onde dispositivos operam em múltiplos canais ou saltos rápidos de frequência. Atribui múltiplas interfaces sequencialmente em todos os canais.
• zbassocflood - Associa-se repetidamente ao PANID alvo na tentativa de fazer o dispositivo travar devido a muitas estações conectadas.
• zbconvert - Converte uma captura de pacotes do formato Libpcap para Daintree SNA, ou vice-versa.
• zbdsniff - Captura tráfego ZigBee, procurando por quadros NWK e provisionamento de chave over-the-air. Quando uma chave é encontrada, zbdsniff imprime a chave no stdout. A captura de pacotes de exemplo sample/zigbee-network-key-ota.dcf pode ser usada para demonstrar esta funcionalidade.
• zbfind - Um aplicativo GUI GTK para rastrear a localização de um transmissor IEEE 802.15.4 medindo RSSI. O zbfind pode ser passivo na descoberta (apenas escutar pacotes) ou pode ser ativo enviando quadros de Solicitação de Beacon e registrando as respostas de roteadores e coordenadores ZigBee. Se você receber muitos erros após iniciar esta ferramenta, certifique-se de que sua variável DISPLAY esteja configurada corretamente.
• zbgoodfind - Implementa uma função de busca de chave usando uma captura de pacotes criptografada e um dump de memória de um dispositivo legítimo ZigBee ou IEEE 802.15.4. Esta ferramenta acompanha a ferramenta de ataque de hardware GoodFET de Travis Goodspeed, ou outros dados binários que possam conter informações de chave de criptografia, como sniffing de barramento com chips legados (como o CC2420). O arquivo de busca do Zbgoodfind deve estar em formato binário (arquivos hex obj não são suportados). Para converter do formato hexfile para um arquivo binário, use a ferramenta objcopy: objcopy -I ihex -O binary mem.hex mem.bin
• zbwardrive - Descobre interfaces disponíveis e usa uma para injetar solicitações de beacon e escutar respostas através dos canais. Uma vez que uma rede é encontrada em um canal, atribui outro dispositivo para capturar continuamente o tráfego nesse canal para um arquivo PCAP. Scapy deve estar instalado para executar isso.
• zbscapy - Fornece um shell Scapy interativo para interação via uma interface KillerBee. Scapy deve estar instalado para executar isso.
• kbbootloader - Coloca o dispositivo no modo DFU/BOOTLOADER (se o dispositivo for compatível)

Ferramentas adicionais, que são para casos especiais ou não são estáveis, estão armazenadas no repositório do projeto Api-Do: http://code.google.com/p/zigbee-security/ e em https://github.com/riverloopsec/beekeeperwids.

FRAMEWORK

O KillerBee é projetado para simplificar o processo de sniffing de pacotes da interface aérea ou de um arquivo de captura de pacotes suportado (libpcap), e para injetar pacotes arbitrários. Funções auxiliares incluindo decodificadores de pacotes IEEE 802.15.4, ZigBee NWK e ZigBee APS também estão disponíveis.

A API do KillerBee é documentada no formato epydoc, com documentação HTML no diretório doc/ desta distribuição. Se você tiver o epydoc instalado, você também pode gerar um PDF conveniente para impressão, se desejar, conforme mostrado:

O diretório pdf/ terá um arquivo chamado "api.pdf" que inclui a documentação do framework.

Para começar a usar o framework KillerBee, dê uma olhada nas ferramentas incluídas (zbdump e zbreplay são bons exemplos para começar).

Como o KillerBee é uma biblioteca Python, ele também se integra bem com outros softwares Python. Por exemplo, a biblioteca Sulley é um framework de fuzzing escrito em Python por Pedram Amini. Usando os recursos de mutação do Sulley e os recursos de injeção de pacotes do KillerBee, é direto construir um mecanismo para gerar e transmitir dados ZigBee malformados para um alvo.

PERGUNTAS/COMENTÁRIOS/DÚVIDAS

Use o sistema de tickets em https://github.com/riverloopsec/killerbee/issues.

A versão original foi escrita por: [email protected]. A versão atual, correções, etc são tratadas por: [email protected]. (Veja a lista acima para todos os colaboradores/créditos.)

Para colaboradores/desenvolvedores, veja DEVELOPMENT.md para detalhes e orientações.