Pi-PwnBox 🚀 -RogueAP 📡

PwnBox / RogueAP caseiro (headless) baseado em Raspberry Pi e Adaptadores WiFi USB Alfa.

Cheatsheets de Hacking WiFi & Mapa Mental 💡

Projetado para ser usado em:

• Engajamentos de Red Team in loco,
• Avaliações de segurança WiFi,
• Prática de ataques WiFi.

Índice

• Pi-PwnBox-RogueAP
• Equipamento utilizado
• Visão Geral dos Adaptadores WiFi USB
• Requisitos e Compatibilidade
• Instalação
• Configuração de Rede do PwnBox
  • Rede de Administração Dedicada Sem Fio
  • Rede LAN (Sem Fio ou Com Fio)
• Acesso Remoto ao PwnBox
• Uso
• Cheatsheets de Hacking WiFi & Mapa Mental
• Solução de Problemas
• Possível Atualização

Equipamento utilizado

• Raspberry Pi 3 Model B+, Pi 4 ou Pi 5
• Cartão Micro SD de 64 GB (classe 10 ou superior, UHS-I recomendado)
• Case para Raspberry Pi (com resfriamento passivo/ativo para Pi 4/5)
• Adaptador WiFi USB Alfa AWUS036NEH
• Adaptador WiFi USB Alfa AWUS036ACH
• Adaptador WiFi USB BrosTrend AC1L AC1200 (pode ser substituído por qualquer adaptador que suporte modo AP)
• Cabo USB Macho para Fêmea
• Teclado sem fio Rii Mini (opcional)
• Powerbank (mínimo 2,5A para Pi 3, 3A+ para Pi 4/5)

Visão Geral dos Adaptadores WiFi USB

* exigiria patch nexmon para habilitar modo monitor e suporte a injeção no chip Broadcom integrado (mas não precisamos disso para seu uso aqui).

Requisitos e Compatibilidade

• SO: Kali Linux ARM para Raspberry Pi (64 bits recomendado para Pi 4/5).
• Internet: Durante a instalação, o PwnBox deve ter acesso à Internet.
• Root: O script de instalação deve ser executado como root.
• Nota para Pi 4/5: A imagem ARM Kali 64 bits é altamente recomendada. Todas as ferramentas funcionam em arm64, mas alguns binários pré-compilados mais antigos podem exigir box64 ou compilação manual.

Instalação

1. Baixe a imagem Kali Linux ARM para Raspberry Pi: https://www.kali.org/get-kali/#kali-arm

2. Grave a imagem Kali Linux ARM para Raspberry Pi no cartão Micro SD (use Raspberry Pi Imager ou dd).

3. Inicialize o Raspberry Pi, faça login (padrão kali/kali) e certifique-se de que tenha conexão com a Internet.

4. Baixe os scripts/configurações de instalação no PwnBox:

   root@kitploit:~

   git clone https://github.com/koutto/pi-pwnbox-rogueap.git
   

5. Importante: Edite a configuração do script de instalação no início do arquivo scripts/install-system.sh:

   • Escolha as senhas do Guacamole (GUACAMOLE_PASSWORD, GUACAMOLE_MYSQL_PASSWORD).
   • Defina nomes persistentes das interfaces WiFi com base em seus endereços MAC: wlxaabbccddeeff para um dispositivo com endereço MAC aa:bb:cc:dd:ee:ff.
   • Defina os endereços MAC de eth0 e wlan0 (interfaces integradas).

Configuração de Rede do PwnBox

Rede de Administração Dedicada Sem Fio

Ao inicializar, o PwnBox cria automaticamente um AP em uma interface para permitir acesso remoto fácil:

• SSID = PWNBOX_ADMIN (SSID oculto)
• Senha WPA2 (PSK) = Koutto!PwnB0x!
• IP do AP = 10.0.0.1 (quando conectado a esta rede, o PwnBox pode ser acessado neste IP)
• Faixa de rede = 10.0.0.1/24

Rede LAN (Sem Fio ou Com Fio)

Ao inicializar, o PwnBox se conecta automaticamente a:

• Rede com fio se a porta Ethernet estiver conectada.

• Rede WiFi (usando o chip Raspberry Pi integrado) se houver uma rede sem fio disponível com configurações de conexão salvas (em /etc/wpa_supplicant.conf). Se você quiser conectar a uma nova rede WiFi (não salva no PwnBox), é necessário adicionar a senha WPA da rede antes:

  1. Acesse o PwnBox usando outro método, por exemplo:

     • Use a rede de administração dedicada sem fio (abordagem mais conveniente),
     • Use a rede com fio,
     • Use monitor + teclado (sem fio).

  2. Adicione a senha WPA à configuração local do PwnBox:

     root@kitploit:~

     wpa_passphrase <SSID> <senha> >> /etc/wpa_supplicant.conf
     

  3. Teste a conexão:

     root@kitploit:~

     wpa_supplicant -B -i wlan0 -c /etc/wpa_supplicant.conf
     dhclient -v wlan0
     ping 8.8.8.8
     

Acesso Remoto ao PwnBox

O PwnBox pode ser controlado através de:

• Serviço SSH (22/tcp):

  root@kitploit:~

  ssh kali@<ip_pwnbox>
  

• VNC-over-HTTP com Guacamole (8080/tcp):

  root@kitploit:~

  http://<ip_pwnbox>:8080/guacamole
  

O IP do PwnBox depende da rede a partir da qual você deseja acessá-lo:

• Via Rede de Administração Dedicada Sem Fio (ou seja, conectado ao SSID oculto PWNBOX_ADMIN): O IP é sempre 10.0.0.1.
• Via Rede LAN (sem fio ou com fio): O IP depende do valor alocado pelo servidor DHCP. O IP pode ser encontrado usando netdiscover, por exemplo.

Nota: O serviço Guacamole pode consumir muitos recursos (RAM) quando em execução. Se não estiver em uso, pode ser parado usando o script stop-guacamole.sh.

Uso

• Na maioria das vezes, apenas o acesso SSH é necessário (ferramentas de linha de comando).
• Ferramentas adicionais são instaladas em /usr/share.
• Ferramentas com GUI ou que exigem a criação de múltiplos xterm (ex.: airgeddon) podem ser executadas através do Guacamole.
• Ferramentas com interface web (ex.: Kismet, Bettercap) podem ser iniciadas e acessadas remotamente.

Cheatsheets de Hacking WiFi & Mapa Mental

• Mapa Mental de Hacking WiFi [versão PDF]

• Cheatsheets de Teoria de Hacking WiFi
• Cheatsheets de Comandos de Hacking WiFi
• Cheatsheets de Comandos MitM

Solução de Problemas

Inicialização lenta quando o cabo Ethernet está desconectado

Como /etc/network/interfaces usa auto eth0, o sistema aguarda uma concessão DHCP durante a inicialização. Se você executa o PwnBox frequentemente sem Ethernet e experimenta inicializações lentas, edite /etc/network/interfaces e altere:

auto eth0
allow-hotplug eth0

para:

allow-hotplug eth0

(Remova a linha auto eth0.)

Aviso de conflito de serviço DHCP

O isc-dhcp-server está instalado porque algumas ferramentas (ex.: Fluxion) o exigem, mas está desabilitado por padrão para evitar conflito na porta 67/udp com o dnsmasq (que serve o AP PWNBOX_ADMIN). Se você precisar do isc-dhcp-server, pare o dnsmasq primeiro:

systemctl stop dnsmasq
systemctl start isc-dhcp-server

Serviço Guacamole / Tomcat não inicia

Versões mais recentes do Kali/Debian trazem Tomcat 10 em vez do Tomcat 9. Os scripts start-guacamole.sh e stop-guacamole.sh detectam automaticamente a versão do Tomcat instalada. Se o Guacamole não funcionar após a instalação, verifique:

systemctl list-unit-files | grep tomcat
systemctl status guacd
systemctl status mysql
# Em seguida, inicie manualmente com a versão correta do tomcat, ex.:
systemctl start tomcat10

Problemas com driver BrosTrend AC1L

Se o instalador do fornecedor (deb.trendtechcn.com) estiver offline, compile o driver manualmente:

sudo apt-get install -y bc git build-essential dkms
sudo git clone https://github.com/cilynx/rtl88x2bu.git /usr/src/rtl88x2bu-5.8.7
sudo dkms add -m rtl88x2bu -v 5.8.7
sudo dkms autoinstall

Servidor VNC não inicia

Certifique-se de que você executou vncpasswd durante a instalação para criar o arquivo de senha:

vncpasswd
systemctl restart vncserver

Ferramentas Python 2 não funcionam mais

O Python 2 foi removido do Kali moderno. O script de instalação agora usa apenas Python 3. Se você possui ferramentas Python 2 personalizadas antigas, migre-as para Python 3 ou execute-as em um contêiner Docker dedicado.

Sem Internet após desabilitar NetworkManager

O script de instalação desabilita o NetworkManager em favor do clássico /etc/network/interfaces. Se você precisar reabilitar temporariamente o NM:

systemctl start NetworkManager
systemctl enable NetworkManager

Nomes das interfaces wireless mudaram após reinicialização

Verifique se os endereços MAC em install-system.sh correspondem à realidade:

ip link show

Em seguida, execute novamente a seção de configuração de rede ou atualize /etc/udev/rules.d/70-persistent-net.rules manualmente.

Possível Atualização

• Adicionar dongle USB 4G para acesso remoto ao PwnBox usando rede celular 4G.
• Substituir o BrosTrend AC1L por um adaptador dual-band com suporte a AP e 802.11ax (WiFi 6) para melhor desempenho.
• Adicionar módulo GPS USB para wardriving com Kismet.