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.

Pi-PwnBox-RogueAP

Í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

Dispositivo	Chipset	Uso	802.11	2,4 Ghz	5 Ghz	Kali pronto para uso	Modo Monitor	Injeção	AP
Chip WiFi integrado Raspberry Pi 3 B+	Broadcom 43430	Conexão à Internet (início automático na inicialização se chave WiFi adicionada na config)	802.11 b/g/n/ac	S	S	S	N*	N*	S
BrosTrend AC1L AC1200	Realtek RTL8812AU	Ponto de Acesso para Acesso Remoto (início automático na inicialização)	802.11 a/b/g/n/ac	S	S	N	S	N	S
Alfa AWUS036NEH	Ralink RT2870/3070	Ataques WiFi	802.11 b/g/n	S	N	S	S	S	S
Alfa AWUS036ACH	Realtek RTL8812AU	Ataques WiFi	802.11 a/b/g/n/ac	S	S	S	S	S	S

* 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

Baixe a imagem Kali Linux ARM para Raspberry Pi: https://www.kali.org/get-kali/#kali-arm
Grave a imagem Kali Linux ARM para Raspberry Pi no cartão Micro SD (use Raspberry Pi Imager ou dd).
Inicialize o Raspberry Pi, faça login (padrão kali/kali) e certifique-se de que tenha conexão com a Internet.

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

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

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).
- Defina as configurações de conexão WiFi (WIFI_SSID, WIFI_PASSPHRASE).
Execute o script de instalação (pausará no final de cada etapa para permitir inspeção manual das saídas dos comandos)
```
cd pi-pwnbox-rogueap/scripts
./install-system.sh
```
Reinicie e verifique a configuração correta das interfaces de rede:
```
ip a
iwconfig
```
- As interfaces com e sem fio integradas devem ser nomeadas eth0 e wlan0, respectivamente.
- Os adaptadores WiFi USB devem usar nomes persistentes (convenção de nomenclatura moderna wlx*).
- O AP (PWNBOX_ADMIN) deve ser iniciado na interface wlx* apropriada.
Configure VNC-over-HTTP no Guacamole:
1. Conecte-se ao Guacamole em http://<ip_pwnbox>:8080/guacamole/
2. Vá para guacadmin (canto superior direito) > Settings > Connections
3. Clique em New Connection
4. Preencha as configurações de conexão da seguinte forma:
  - Name = pwnbox-vnc
  - Location = ROOT
  - Protocol = VNC
  - Maximum number of connections = 3
  - Maximum number of connections = 3
  - Guacamole Proxy Hostname = 127.0.0.1
  - Guacamole Proxy Port = 4822
  - Network Hostname = 127.0.0.1
  - Network Port = 5901
  - Authentication Password = (senha escolhida na instalação ao executar install-system.sh)
  - Color depth = True color (32-bit)
Altere as credenciais padrão:
- Credenciais do sistema Kali (passwd kali)
- Credenciais do Guacamole (via http://<ip_pwnbox>:8080/guacamole/#/manage/mysql/users/guacadmin)

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:
```
wpa_passphrase <SSID> <senha> >> /etc/wpa_supplicant.conf
```
3. Teste a conexão:
```
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):
```
ssh kali@<ip_pwnbox>
```
VNC-over-HTTP com Guacamole (8080/tcp):
```
http://<ip_pwnbox>:8080/guacamole
```

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

pi-pwnbox-rogueap

Mais Populares