risinek/esp32-wifi-penetration-toolESP32プラットフォームを使用して近くのWi-Fiネットワークへの攻撃の可能性を探る。
このプロジェクトは、ESP32 プラットフォーム向けの汎用ツールを紹介し、さまざまな Wi-Fi 攻撃を実装するためのものです。Wi-Fi 攻撃で一般的に使用される共通機能を提供し、新しい攻撃の実装を少し簡単にします。また、ハンドシェイクから PMKID をキャプチャしたり、ログ重複 AP を起動したり、直接 deauthentication フレームを送信するなど、さまざまな方法でハンドシェイク自体をキャプチャするなどの Wi-Fi 攻撃自体も含まれています。
当然、クラッキングはこのプロジェクトの一部ではありません。ESP32 ではハッシュを効果的にクラックするには不十分だからです。残りの処理は、この小型で安価、低消費電力の SoC で実行できます。
ESP32 に電源を投入します
起動後に管理 AP が自動的に開始されます
この AP に接続します
デフォルト: SSID: ManagementAP および パスワード: mgmtadmin
ブラウザで 192.168.4.1 を開くと、以下のようなツールを設定および制御するための Web クライアントが表示されます。
このプロジェクトは現在、ESP-IDF 4.1 (コミット 5ef1b390026270503634ac3ec9f1ec2e364e23b2) を使用して開発されています。新しいバージョンでは動作しない可能性があります。
プロジェクトは通常の ESP-IDF の方法でビルドできます。
idf.py build
make を使用した従来の方法はこのプロジェクトではサポートされていません。
ESP-IDF を設定している場合、最も簡単な方法は idf.py flash を使用することです。
ESP-IDF 全体をセットアップしたくない場合は、build/ に含まれているプリビルドバイナリを使用し、esptool.py を使ってフラッシュできます (Python が必要です)。
コマンド例 (esptool リポジトリの指示に従ってください):
esptool.py -p /dev/ttyS5 -b 115200 --after hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size detect 0x8000 build/partition_table/partition-table.bin 0x1000 build/bootloader/bootloader.bin 0x10000 build/esp32-wifi-penetration-tool.bin
Windows では、公式の Flash Download Tool を使用できます。
このプロジェクトの攻撃実装は メインコンポーネント README に記載されています。これらの攻撃の背後にある理論は doc/ATTACKS_THEORY.md にあります。
このプロジェクトでは、コンポーネントの API と実装を文書化するために Doxygen 表記を使用しています。Doxyfile が含まれているので、API リファレンスを生成したい場合は、ルートディレクトリで doxygen を実行するだけです。HTML API リファレンスが doc/api/html に生成されます。
このプロジェクトは、他のプロジェクトで再利用できる複数のコンポーネントで構成されています。各コンポーネントには詳細な説明が記載された独自の README があります。以下にコンポーネントの簡単な説明を示します。
このプロジェクトは主に ESP32-DEVKITC-32E 上で構築およびテストされましたが、ESP32-WROOM-32 モジュールでも違いはないはずです。
以下の画像では、次のハードウェアを使用したバッテリー (Li-Pol 蓄電池) 駆動の ESP32 DevKitC を見ることができます。
全体で (硬貨を除いて) このセットアップの重量は約 17g です。これは、より小さな Li-Pol 蓄電池を使用し、開発ボード全体ではなく ESP32-WROOM-32 モジュールを直接使用することで、さらに小型化できます。
このセットアップの費用は約 300 CZK (± 11.50 EUR/13.50 USD) でした。モジュールを直接使用すると、約 80 CZK (± 3 EUR/3.5 USD) なので、160 CZK (± 6.5 EUR/7.5 USD) の価格になり、このツールは非常に安価でほぼすべての人が利用できるようになります。
実験的な測定に基づくと、ESP32 は攻撃実行中に約 100mA を消費します。
気軽に貢献してください。現在のコードベースのリファクタリングを躊躇しないでください。新しい関数やファイルにコメントするときは、Doxygen 表記に従ってください。このプロジェクトは主に教育およびデモンストレーション目的で構築されているため、詳細なドキュメントは歓迎されます。
このプロジェクトは、Wi-Fi ネットワークとその基盤となる 802.11 標準の脆弱性、および ESP32 プラットフォームをどのように利用してそれらの脆弱な箇所を攻撃できるかを示しています。攻撃の許可を得たネットワークに対して責任を持って使用してください。
このプロジェクトは MIT ライセンスの下でライセンスされていますが (詳細は LICENSE ファイルを参照)、遠慮や貪欲にならずにあなたの作品を共有してください。