Pi-PwnBox 🚀 -RogueAP 📡

自作（ヘッドレス）PwnBox / RogueAP（Raspberry Pi & Alfa WiFi USBアダプター使用）

WiFiハッキングのチートシート＆マインドマップ 💡

以下の用途向けに設計:

• オンサイトのRed Teamエンゲージメント
• WiFiセキュリティ評価
• WiFi攻撃の練習

目次

• Pi-PwnBox-RogueAP
• 使用機材
• WiFi USBアダプター概要
• 要件と互換性
• インストール
• PwnBoxネットワーク構成
  • 無線専用管理ネットワーク
  • LANネットワーク（無線または有線）
• PwnBoxへのリモートアクセス
• 使用方法
• WiFiハッキングのチートシート＆マインドマップ
• トラブルシューティング
• 考えられるアップグレード

使用機材

• Raspberry Pi 3 Model B+、Pi 4 または Pi 5
• Micro SDメモリーカード 64 GB（クラス10以上、UHS-I推奨）
• Raspberry Piケース（Pi 4/5用にパッシブ/アクティブ冷却対応）
• Alfa WiFi USBアダプター AWUS036NEH
• Alfa WiFi USBアダプター AWUS036ACH
• BrosTrend WiFi USBアダプター AC1L AC1200（APモードに対応する任意のアダプターに置き換え可能）
• USBケーブル（オス-メス）
• Rii Miniワイヤレスキーボード（オプション）
• モバイルバッテリー（Pi 3は最小2.5A、Pi 4/5は3A+）

WiFi USBアダプター概要

* Broadcom内蔵チップでモニターモードとインジェクションを有効にするには nexmon パッチが必要ですが、ここでの使用には不要です。

要件と互換性

• OS: Raspberry Pi用 Kali Linux ARM（Pi 4/5では64ビット推奨）。
• インターネット: インストール中、PwnBoxはインターネットに接続している必要があります。
• root: インストールスクリプトは root で実行する必要があります。
• Pi 4/5の注意: 64ビットのKali ARMイメージを強く推奨します。すべてのツールは arm64 で動作しますが、古いプリコンパイル済みバイナリの中には box64 や手動コンパイルが必要な場合があります。

インストール

1. Raspberry Pi用Kali Linux ARMイメージをダウンロード: https://www.kali.org/get-kali/#kali-arm

2. ダウンロードしたKali Linux ARMイメージをMicro SDカードに書き込みます（Raspberry Pi Imager または dd を使用）。

3. Raspberry Piを起動し、ログイン（デフォルトはkali/kali）し、インターネット接続があることを確認します。

4. PwnBoxにインストールスクリプト/設定ファイルをダウンロード:

   root@kitploit:~

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

5. 重要: scripts/install-system.sh ファイルの先頭にあるインストールスクリプトの設定を編集します:

   • Guacamole のパスワードを選択（GUACAMOLE_PASSWORD、GUACAMOLE_MYSQL_PASSWORD）。
   • MACアドレスに基づいてWiFiインターフェースの永続的な名前を設定: MACアドレスが aa:bb:cc:dd:ee:ff のデバイスには wlxaabbccddeeff。
   • eth0 と wlan0（内蔵インターフェース）のMACアドレスを設定。
   • WiFi接続設定を設定（WIFI_SSID、）。

PwnBoxネットワーク構成

無線専用管理ネットワーク

起動時に、PwnBoxは自動的に1つのインターフェースにAPを生成し、簡単なリモートアクセスを可能にします:

• SSID = PWNBOX_ADMIN（非表示SSID）
• WPA2 パスフレーズ（PSK） = Koutto!PwnB0x!
• AP IP = 10.0.0.1（このネットワークに接続すると、このIPでPwnBoxにアクセスできます）
• ネットワーク範囲 = 10.0.0.1/24

LANネットワーク（無線または有線）

起動時に、PwnBoxは自動的に以下に接続します:

• Ethernetポートが接続されている場合は有線ネットワーク。

• 保存された接続設定（/etc/wpa_supplicant.conf 内）がある利用可能な無線ネットワークがある場合はWiFiネットワーク（Raspberry Pi内蔵チップ使用）。PwnBoxに保存されていない新しいWiFiネットワークに接続する場合は、事前にネットワークのWPAパスフレーズを追加する必要があります:

  1. 別の方法でPwnBoxにアクセスします。例:
     • 無線専用管理ネットワークを使用（最も便利）
     • 有線ネットワークを使用
     • モニター＋（ワイヤレス）キーボードを使用
  2. PwnBoxのローカル設定にWPAパスフレーズを追加:
     root@kitploit:~

     wpa_passphrase <SSID> <パスフレーズ> >> /etc/wpa_supplicant.conf
     

  3. 接続をテスト:
     root@kitploit:~

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

PwnBoxへのリモートアクセス

PwnBoxは以下から制御できます:

• SSHサービス（22/tcp）:

  root@kitploit:~

  ssh kali@<pwnbox_ip>
  

• Guacamoleを使用したVNC-over-HTTP（8080/tcp）:

  root@kitploit:~

  http://<pwnbox_ip>:8080/guacamole
  

PwnBoxのIP は、アクセスするネットワークによって異なります:

• 無線専用管理ネットワーク経由（つまり、非表示SSID PWNBOX_ADMIN に接続時）: IPは常に 10.0.0.1 です。
• LANネットワーク経由（無線または有線）: IPはDHCPサーバーが割り当てた値に依存します。IPは例えば netdiscover を使用して見つけることができます。

注: Guacamoleサービスは動作中に多くのリソース（RAM）を消費する可能性があります。使用しない場合は、stop-guacamole.sh スクリプトで停止できます。

使用方法

• ほとんどの場合、SSHアクセスだけで十分です（CLIツール）。
• 追加のツールは /usr/share にインストールされます。
• GUIが必要なツールや複数の xterm を起動するツール（例: airgeddon）は Guacamole 経由で実行できます。
• Web UIを持つツール（例: Kismet、Bettercap）は起動してリモートからアクセスできます。

WiFiハッキングのチートシート＆マインドマップ

• WiFiハッキングマインドマップ [PDF版]

• WiFiハッキング理論チートシート
• WiFiハッキングコマンドチートシート
• MitMコマンドチートシート

トラブルシューティング

Ethernetケーブル未接続時の起動が遅い

/etc/network/interfaces が auto eth0 を使用しているため、システムは起動中にDHCPリースを待機します。EthernetなしでPwnBoxを頻繁に使用し、起動が遅い場合は、/etc/network/interfaces を編集し、以下のように変更:

auto eth0
allow-hotplug eth0

を:

allow-hotplug eth0

に変更します（auto eth0 行を削除）。

DHCPサービスの競合警告

一部のツール（例: Fluxion）で必要となるため isc-dhcp-server がインストールされていますが、dnsmasq（PWNBOX_ADMIN APを提供）とのポート67/udpの競合を避けるため、デフォルトでは無効 になっています。isc-dhcp-server が必要な場合は、まず dnsmasq を停止:

systemctl stop dnsmasq
systemctl start isc-dhcp-server

Guacamole / Tomcatサービスの起動に失敗

新しいKali/Debianリリースでは、Tomcat 9の代わりに Tomcat 10 が同梱されています。start-guacamole.sh および stop-guacamole.sh スクリプトは、インストールされているTomcatバージョンを自動検出します。インストール後にGuacamoleが動作しない場合は、以下を確認:

systemctl list-unit-files | grep tomcat
systemctl status guacd
systemctl status mysql
# その後、正しいTomcatバージョンで手動起動。例:
systemctl start tomcat10

BrosTrend AC1Lドライバーの問題

ベンダーのインストーラー（deb.trendtechcn.com）がオフラインの場合、ドライバーを手動でビルド:

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

VNCサーバーが起動しない

インストール時に vncpasswd を実行してパスワードファイルを作成したことを確認:

vncpasswd
systemctl restart vncserver

Python 2ツールが動作しなくなった

Python 2は最新のKaliから削除されました。インストールスクリプトは Python 3のみ を使用するようになりました。古いカスタムPython 2ツールがある場合は、Python 3に移行するか、専用のDockerコンテナ内で実行してください。

NetworkManager無効化後にインターネットに接続できない

インストールスクリプトは、NetworkManagerを無効にして、従来の /etc/network/interfaces を優先します。一時的にNMを再有効化する必要がある場合:

systemctl start NetworkManager
systemctl enable NetworkManager

再起動後に無線インターフェース名が変わった

install-system.sh のMACアドレスが実際と一致しているか確認:

ip link show

その後、ネットワーク設定セクションを再実行するか、/etc/udev/rules.d/70-persistent-net.rules を手動で更新してください。

考えられるアップグレード

• 4G USBドングルを追加して、4Gセルラーネットワーク経由でPwnBoxにリモートアクセス。
• BrosTrend AC1Lを、パフォーマンス向上のために802.11ax（WiFi 6）に対応したデュアルバンドAP対応アダプターに交換。
• GPS USBモジュールを追加して、Kismetを使ったワードライビングを実行。