Pi-PwnBox 🚀 -RogueAP 📡

PwnBox / RogueAP fait maison (sans écran) basé sur Raspberry Pi et adaptateurs WiFi USB Alfa.

Aides-mémoire et carte mentale pour le hacking WiFi 💡

Conçu pour être utilisé pour :

• Engagements Red Team sur site,
• Évaluations de sécurité WiFi,
• Pratique des attaques WiFi.

Table des matières

• Pi-PwnBox-RogueAP
• Équipement utilisé
• Aperçu des adaptateurs WiFi USB
• Prérequis et compatibilité
• Installation
• Configuration réseau du PwnBox
  • Réseau d'administration sans fil dédié
  • Réseau LAN (sans fil ou filaire)
• Accès à distance au PwnBox
• Utilisation
• Aides-mémoire et carte mentale pour le hacking WiFi
• Dépannage
• Améliorations possibles

Équipement utilisé

• Raspberry Pi 3 Model B+, Pi 4 ou Pi 5
• Carte mémoire Micro SD 64 Go (classe 10 ou mieux, UHS-I recommandé)
• Boîtier Raspberry Pi (avec refroidissement passif/actif pour Pi 4/5)
• Adaptateur WiFi USB Alfa AWUS036NEH
• Adaptateur WiFi USB Alfa AWUS036ACH
• Adaptateur WiFi USB BrosTrend AC1L AC1200 (peut être remplacé par tout adaptateur supportant le mode AP)
• Câble USB mâle vers femelle
• Clavier sans fil Rii Mini (optionnel)
• Powerbank (minimum 2,5 A pour Pi 3, 3 A+ pour Pi 4/5)

Aperçu des adaptateurs WiFi USB

Périphérique	Chipset	Utilisation	802.11	2,4 Ghz	5 Ghz	Kali prêt à l'emploi	Mode Moniteur	Injection	AP
Puce WiFi intégrée Raspberry Pi 3 B+	Broadcom 43430	Connexion à Internet (démarrage automatique si clé WiFi ajoutée dans la config)	802.11 b/g/n/ac	O	O	O	N*	N*	O
BrosTrend AC1L AC1200	Realtek RTL8812AU	Point d'accès pour accès à distance (démarrage automatique)	802.11 a/b/g/n/ac	O	O	N	O	N	O
Alfa AWUS036NEH	Ralink RT2870/3070	Attaques WiFi	802.11 b/g/n	O	N	O	O	O	O
Alfa AWUS036ACH	Realtek RTL8812AU	Attaques WiFi	802.11 a/b/g/n/ac	O	O	O	O	O	O

* nécessiterait le correctif nexmon pour activer le mode moniteur et l'injection sur la puce Broadcom intégrée (mais nous n'en avons pas besoin pour son utilisation ici).

Prérequis et compatibilité

• OS : Kali Linux ARM pour Raspberry Pi (64 bits recommandé pour Pi 4/5).
• Internet : Pendant l'installation, le PwnBox doit avoir accès à Internet.
• Root : Le script d'installation doit être exécuté en tant que root.
• Remarque pour Pi 4/5 : L'image ARM Kali 64 bits est fortement recommandée. Tous les outils fonctionnent sur arm64, mais certains binaires précompilés plus anciens peuvent nécessiter box64 ou une compilation manuelle.

Installation

1. Téléchargez l'image Kali Linux ARM pour Raspberry Pi : https://www.kali.org/get-kali/#kali-arm

2. Flashez l'image Kali Linux ARM pour Raspberry Pi sur la carte Micro SD (utilisez Raspberry Pi Imager ou dd).

3. Démarrez le Raspberry Pi, connectez-vous (kali/kali par défaut) et assurez-vous qu'il a une connexion Internet.

4. Téléchargez les scripts/configurations d'installation sur le PwnBox :

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

5. Important : Modifiez la configuration du script d'installation en haut du fichier scripts/install-system.sh :

   • Choisissez les mots de passe Guacamole (GUACAMOLE_PASSWORD, GUACAMOLE_MYSQL_PASSWORD).
   • Définissez des noms persistants pour les interfaces WiFi en fonction de leurs adresses MAC : wlxaabbccddeeff pour un périphérique avec l'adresse MAC aa:bb:cc:dd:ee:ff.
   • Définissez les adresses MAC de eth0 et wlan0 (interfaces intégrées).
   • Définissez les paramètres de connexion WiFi (WIFI_SSID, WIFI_PASSPHRASE).

6. Exécutez le script d'installation (il fera une pause à la fin de chaque étape pour permettre une inspection manuelle des sorties des commandes)

   cd pi-pwnbox-rogueap/scripts
   ./install-system.sh
   

7. Redémarrez et vérifiez la configuration correcte des interfaces réseau :

   ip a
   iwconfig
   

   • Les interfaces filaires et sans fil intégrées doivent être nommées respectivement eth0 et wlan0.
   • Les adaptateurs WiFi USB doivent utiliser des noms persistants (convention de nommage moderne wlx*).
   • Le point d'accès (PWNBOX_ADMIN) doit être démarré sur l'interface wlx* appropriée.

8. Configurez VNC-over-HTTP sur Guacamole :

   1. Connectez-vous à Guacamole à l'adresse http://<ip_pwnbox>:8080/guacamole/
   2. Allez dans guacadmin (en haut à droite) > Settings > Connections
   3. Cliquez sur New Connection
   4. Remplissez les paramètres de connexion comme suit :
      • Name = pwnbox-vnc
      • Location = ROOT
      • Protocol = VNC
      • 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 = (mot de passe choisi lors de l'installation en exécutant install-system.sh)
      • Color depth = True color (32-bit)

9. Changez les identifiants par défaut :

   • Identifiants système Kali (passwd kali)
   • Identifiants Guacamole (via http://<ip_pwnbox>:8080/guacamole/#/manage/mysql/users/guacadmin)

Configuration réseau du PwnBox

Réseau d'administration sans fil dédié

Au démarrage, le PwnBox crée automatiquement un point d'accès sur une interface pour permettre un accès à distance facile :

• SSID = PWNBOX_ADMIN (SSID masqué)
• Phrase de passe WPA2 (PSK) = Koutto!PwnB0x!
• IP du point d'accès = 10.0.0.1 (lorsqu'il est connecté à ce réseau, le PwnBox est accessible à cette IP)
• Plage réseau = 10.0.0.1/24

Réseau LAN (sans fil ou filaire)

Au démarrage, le PwnBox se connecte automatiquement à :

• Réseau filaire si le port Ethernet est branché.

• Réseau WiFi (en utilisant la puce intégrée du Raspberry Pi) s'il existe un réseau sans fil disponible avec les paramètres de connexion enregistrés (dans /etc/wpa_supplicant.conf). Si vous souhaitez vous connecter à un nouveau réseau WiFi (non enregistré dans le PwnBox), il est nécessaire d'ajouter la phrase de passe WPA du réseau avant :

  1. Accédez au PwnBox par un autre moyen, par exemple :

     • Utilisez le réseau d'administration sans fil dédié (méthode la plus pratique),
     • Utilisez le réseau filaire,
     • Utilisez un moniteur + clavier (sans fil).

  2. Ajoutez la phrase de passe WPA à la configuration locale du PwnBox :

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

  3. Testez la connexion :

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

Accès à distance au PwnBox