現在、アプリはオランダ語版のみ利用可能です。英語版はまもなく公開予定です。

ユーザーガイド – Wi-Fi パッシブモニター（ESSID + バンドフィルター）

法的・倫理的注意事項（教育目的での使用）

教育目的および許可を得たテスト専用です。 このツールの使用方法については、すべての責任はあなたにあります。所有していない、またはテストのための書面による許可を得ていないネットワークを意図的に妨害することは、お住まいの地域では違法となる場合があります。他人のネットワークに送信される認証解除（deauthentication）フレームが1つだけでも違法になり得ます。明示的な許可を得た場合のみ、自己責任で使用してください。

1) 目的（概要）

このアプリケーションは、対象SSIDを発見し、一致するBSSIDをバンド（2.4/5/6 GHz）ごとに一覧表示し、各BSSIDをパッシブモニタリングしてクライアントを列挙し、存在する場合はWPAハンドシェイクを**.22000にキャプチャします。認証解除（deauth）ボタンは実際に動作します**。アクティブな認証解除が実行されます。

2) システム要件

OS: iw、ip、systemd/NetworkManager を備えた Linux。
ツール: airodump-ng（aircrack-ngスイート）、airmon-ng、hcxpcapngtool、iw、ip、systemctl。
権限: rootで実行してください（またはキャプチャツールに必要な同等のケーパビリティを付与してください）。
Wi-Fiアダプター: モニターモードと対象のバンドをサポートしている必要があります。6 GHzには最新のチップセット/ドライバー/カーネルが必要です。

3) 初回セットアップ

ツールがインストールされていることを確認します: which airodump-ng、which hcxpcapngtool など。
アプリを起動します: python3 your_script.py。
「Run this script as root」と表示された場合は、十分な権限で再起動します。

ヒント: 環境をすばやく検証するには、セルフテスト（§12参照）を使用します。

4) ファイルとフォルダー

logs/<SAFE_ESSID>/session.log – ローテーション式のセッションログ（約5 MBでローテーション）。
logs/<SAFE_ESSID>/discovery-01.csv – 最新のバンド発見の出力。
logs/<SAFE_ESSID>/<ESSID>_mon-01.csv – BSSIDごとのモニターCSV。
logs/<SAFE_ESSID>/aliases.json – クライアントMAC用の、人間が読めるエイリアス。
logs/<SAFE_ESSID>/session.json – セッションデータ（BSSID、クライアント、件数）。
logs/<SAFE_ESSID>/*hs*.22000 – パッシブにキャプチャされたWPAハンドシェイク。

<SAFE_ESSID> は、ESSIDをファイル名に安全な形へサニタイズしたものです。

5) メインウィンドウの概要

5.1 トップバー（入力）

Wi-Fiインターフェース 物理デバイス（例: wlan1）。
モニター名 モニターモードで使用する名前（例: mon0）。必要に応じて、アプリがモードを切り替えて名前を変更します。
バンド（2.4 / 5 / 6 GHz） 対象ESSIDをスキャンするバンド。6 GHzには最新のaircrack-ngとドライバーのサポートが必要です。
ESSID 対象とする正確なSSID（大文字と小文字を区別）。
ログレベル basic（最小限）、verbose（より詳細）、debug（最大限の詳細）。
発見（秒） バンド発見パスの所要時間。
BSSIDごとのスキャン（秒） クライアントを列挙するための、BSSIDごとのパッシブ待受時間。
開始 / 停止 パイプラインを実行または停止します。停止はプロセスを終了し、該当する場合はNetworkManager/インターフェースの状態を復元します。

5.2 発見テーブル

発見中に確認されたすべてのネットワークを表示します（BSSID、チャンネル、バンド、ESSID）。

オプションフィルター（ビルドで有効な場合）:

検索フィールドは、部分一致のBSSID/ESSIDでフィルタリングします。
隠しSSIDを非表示は、空白または <hidden> の行を削除します。

5.3 ターゲットとBSSIDの選択（バンドフィルタリング済み）

あなたのESSIDと選択したバンドの両方に一致するBSSIDを、チャンネルを含めて一覧表示します。これにより、SSIDに属する正確なAPが特定されます。

5.4 BSSIDごとのモニタリング

ステータス行 – フェーズ、現在のBSSID、残り時間。
プログレスバー – 発見中は不確定表示。BSSIDごとのスキャン中はカウントダウン。
クライアント（現在のBSSID） – ライブのクライアントMAC。設定されている場合はエイリアス付きで表示。
スキップコントロール – 発見をスキップするか、次のBSSIDに進みます。
クライアントとハンドシェイク… – クライアントセンターを開きます（§6参照）。

5.5 ログパネル

タイムスタンプ付きのログ（コマンド、終了コード、コンバーターの出力、エラー）。自動ローテーション付きで session.log に保存されます。 ログディレクトリを開くは、アクティブなセッションフォルダーを開きます。

6) クライアントセンター

6.1 アクセスポイント（左）

ESSIDとバンドに一致するBSSIDを表示します。1つ選択すると、そのクライアントを表示できます。

6.2 クライアント（右）

選択したBSSID配下のクライアントMACを、**最終確認（Last seen）**時刻付きで一覧表示します。

エイリアスの割り当て（ダブルクリックまたはコンテキストメニュー → 名前…） MACに人間が読めるラベルを保存します（aliases.json に保存されます）。 エイリアスの削除は、コンテキストメニュー → エイリアスをクリア で行います。

6.3 アクションバー

モニタリング開始（BSSID） 選択したBSSIDのパッシブハンドシェイクキャプチャを開始します。カウントダウンとEAPOLインジケーターを表示します。
モニタリング停止 キャプチャを停止します。
ブロードキャスト / クライアント指定 プレースホルダーのみです（このビルドではアクティブな認証解除は行いません）。同じBSSIDのパッシブハンドシェイクキャプチャは開始します。
パケット 実験室向けバリアント用のUI値です（ここでは認証解除には使用されません）。
クライアントのエクスポート 既知のすべてのクライアントのCSV（有効な場合はJSONも）をセッションログフォルダーに書き出します。

6.4 .22000 パネル

最新の .22000 ファイルの最初の数行を表示します。
ハッシュのコピーは、テキストをクリップボードにコピーします（このビルドでは自動クリアはありません）。
フォルダーを開くは、.22000 を含むディレクトリを開きます。

6.5 ステータスバー

⏳ タイマー – カウントダウンします（無期限の場合は「running…」と表示）。
EAPOL – コンバーター/標準出力がハンドシェイクを示すと「yes」に切り替わります。

7) 機能的なワークフロー（内部の仕組み）

プリフライト – 必要なバイナリを検証します。欠落している場合は明示的なエラーを表示します。
モニターモード – インターフェースをモニターモードに切り替え、指定したモニター名を適用します。停止/終了時にはシステム状態を復元します。
発見 – airodump-ng --band <bg|a|6> を実行してCSVに出力します。堅牢なヘッダーベースのパーサーが、特殊なESSID/CSV形式も処理します。
BSSIDの選択 – 完全一致のESSIDと選択したバンドでフィルタリングします。
BSSIDごとのモニタリング – チャンネルを固定し（6 GHzでは周波数フォールバックを使用）、airodump-ng --bssid … --channel … を実行します。CSVのStationsセクションを解析して、新しいクライアントをライブ表示します。
ハンドシェイク（.22000） – モニタリング中（またはクライアントセンターのボタン経由）に、最新の .cap を hcxpcapngtool で変換します。空でない .22000 が存在する場合は、それが表示されログに記録されます。サポートされている環境ではデスクトップ通知が送信されます。
ウォッチドッグ – airodump-ng が出力を行わなくなった場合、そのステップ（発見またはBSSIDごと）のプロセスをクリーンに再起動します。
inotify（オプション） – inotifyを使用してファイル変更を即座に解析します。利用できない場合は、軽量なmtimeポーリングにフォールバックします。
ロギング – stdout/stderrの両方をキャプチャし、session.log を自動的にローテーションします。
セッションの永続化 – BSSID/クライアント/エイリアス/カウンターを session.json に継続的に書き込み、同じESSIDでは起動時に再読み込みします。

8) クイックスタート

設定
- Wi-Fiインターフェースを選択します（例: wlan1）。
- モニター名を設定します（例: mon0）。
- バンド（2.4/5/6 GHz）を選択します。
- ESSIDを入力します（正確に）。
- 発見を15〜30秒、BSSIDごとのスキャンを45〜60秒に設定します。
- ログレベルに verbose を選択します。
実行
- 開始をクリックします。発見の進行状況を確認します。
- 完了したら、発見テーブルを確認します。
BSSIDの確認
- バンドフィルタリング済みのリストに、ESSIDのBSSIDが表示されます。
BSSIDごとのクライアント
- アプリはBSSIDを順に処理し、APごとのライブクライアントを一覧表示します。
クライアントセンター
- クライアントとハンドシェイク… を開きます。
- BSSIDを選択 → クライアントを表示します。
- クライアントをダブルクリックしてエイリアスを割り当てます。
- パッシブなハンドシェイクキャプチャのために**モニタリング開始（BSSID）**をクリックします。
- 成功すると: EAPOL: yes と .22000 の内容が表示されます。
- 必要に応じてハッシュのコピーとフォルダーを開くを使用します。
エクスポート
- クライアントのエクスポートをクリックして、CSV（有効な場合はJSONも）を生成します。
停止
- 停止をクリックして、プロセスを終了し、システム状態を復元します。

9) 発見のフィルターと検索（有効な場合）

検索 – 部分一致のESSID/BSSIDでフィルタリングします。
隠しSSIDを非表示 – 空白または <hidden> の行を削除します。
検索をクリアしてチェックを外すと、表示がリセットされます。

10) セッションの保存と再開

アプリは session.json に継続的に書き込みます。同じESSIDで再起動すると、以下が再読み込みされます:

既知のBSSID、
クライアントとエイリアス、
最後のカウンター/設定。

11) エクスポート形式

CSV: BSSID、ESSID、チャンネル、クライアントMAC、エイリアス、最終確認（Last seen）を含む clients.csv。
JSON（オプション）: 同じデータを、機械が扱いやすい形式で出力します。ファイルは logs/<SAFE_ESSID>/ にあります。

12) セルフテスト（診断）

セルフテストウィンドウには、以下が表示されます:

airodump-ng、hcxpcapngtool、iw、ip、systemctl の場所。
iw dev の出力（インターフェース）。
iw list によるケーパビリティ（アダプターがサポートするバンド/チャンネル幅）。

13) 通知とダークモード

有効な .22000 が生成されると、デスクトップ通知が送信されます。
ダークモードは、長時間のセッションに適したダークテーマに切り替えます。

14) ウォッチドッグの動作

airodump-ng が妥当な期間にわたって出力を生成しない場合:

プロセスはクリーンに終了され、そのステップが再起動されます。
トレーサビリティのために、イベントはタイムスタンプ付きでログに記録されます。

15) inotify とポーリング

inotify を使用すると、CSVの変更が即座に解析されます。
inotifyがない場合、アプリは低オーバーヘッドのmtimeポーリングを使用します。
inotifyを使用するとクライアント発見の応答性が向上しますが、どちらのモードもサポートされています。

16) トラブルシューティング

発見結果が空
- バンドの選択を確認します。
- アダプターが 5/6 GHz をサポートしていることを確認します（セルフテスト → iw list）。
- モニターモードがアクティブであることを確認します（iw dev とアプリのログ）。
6 GHz で結果が出ない
- 新しいカーネル/ドライバー/ファームウェアが必要な場合があります。
- 6 GHzでは、多くの場合**周波数設定（frequency set）**のフォールバックが必要です。アプリはこれを試行します。
クライアントが表示されない
- BSSIDごとのスキャンを90〜120秒に増やします。
- より混雑する時間帯に試します。
.22000 が生成されない
- さらに時間をかけ、EAPOLトラフィックが存在することを確認します。
- ログ内の hcxpcapngtool のメッセージを確認します。
UIが応答しない / 状態が不明確
- 停止をクリックします。
- アプリを再起動します。
- 正確なコマンド/終了コードの履歴を session.log で確認します。

17) よくある質問（FAQ）

アプリは認証解除（deauth）を実行しますか？ いいえ。認証解除ボタンはプレースホルダーです。パッシブキャプチャを開始するだけです。

複数のBSSIDを同時にモニタリングできますか？ アプリはBSSIDごとに順次スキャンします。ステータスに進捗が表示されます（例: 「2/5」）。

「ハッシュのコピー」はクリップボードを自動的にクリアしますか？ いいえ。このビルドではクリップボードの内容は保持されます。

出力はどこに保存されますか？ logs/<SAFE_ESSID>/ の下です（§4参照）。

すべてをすばやく開けますか？ メインのログパネルからログディレクトリを開くを使用します。

18) 推奨される運用方法

すばやいフィードバックを得るために、短めの発見（10〜20秒）から始め、必要に応じて延長します。
BSSIDごとのスキャンは45〜60秒以上に設定します。静かなネットワークでは延長します。
頻繁に出現するクライアントにエイリアスを割り当てると、素早く識別できます。
明確にするために、バンドごと（2.4/5/6）に作業します。

AirScout

人気