wifi_db

Aircrack-ng のキャプチャを解析し、SQLite データベースに保存して、有用な情報を抽出するスクリプトです。例えば、ハンドシェイク（22000 hashcat 形式）、エンタープライズ (MGT) の ID と EAP-MD5 チャレンジ/レスポンスペア、各ネットワークの X.509 証明書と RSN/WPA セキュリティ設定、AP がアドバタイズする 802.11r/k/v、マルチ BSSID、チャネルスイッチの機能、AP とクライアント間の興味深い関係、Probe リクエスト、WPS 情報、そして見つかったすべての AP の全体像などを取得します。

目次

• 機能
• インストール
• 使い方
• データベース
• ビュー
• TODO
• ライセンス

機能

• ESSID を持っている場合でも、ネットワークがクローク（非表示）されているかどうかを表示します。
• 接続されているクライアントとその AP の詳細なテーブルを表示します。
• AP に接続しているクライアントの Probe リクエストを識別し、Rogue AP を使った潜在的なセキュリティリスクへの洞察を提供します。
• hashcat で使用するハンドシェイクを抽出し、パスワードクラッキングを容易にします。
• エンタープライズネットワークからの ID 情報を表示し、認証に使用された EAP 方式も含みます。
• エンタープライズ (802.1X) EAP-TLS/PEAP/TTLS 認証で交換される X.509 証明書（AP/サーバー証明書とクライアント証明書の両方）を抽出し、すべての証明書フィールドを AP BSSID ごとに Certificate テーブルに保存します。
• ビーコンから各 AP の RSN/WPA セキュリティ（WPA バージョン、AKM スイート、ペアワイズ/グループ暗号、エンタープライズフラグ、管理フレーム保護）を解析し、AP テーブルに分解して格納します。
• EAP-MD5 チャレンジ/レスポンスペアを取得し、オフラインクラッキング (hashcat -m 4800) のために EAPMD5 テーブルに保存します。
• ランダム化（ローカル管理）されたクライアント MAC アドレスを検出し、Probe リクエストの情報要素からクライアントのフィンガープリントを取得します（Probe テーブルに保存）。
• AP を ESSID と暗号化でグループ化したサマリ（SummaryAP ビュー）を生成します。AP 数とクライアント数、WPA バージョン、PMF の状態、グループごとのすべての製造元を表示し、近隣ネットワークのセキュリティ状況を素早く把握できるようにします（また、混合/ダウングレードされたセキュリティを実行している SSID を特定できます）。
• Wi-Fi Protected Setup (WPS) の各 AP の設定を、そのまま AP 行に記録します。
• クライアントまたは AP が観測されたすべてのインスタンスを GPS データとタイムスタンプとともに記録し、位置情報に基づく分析を可能にします。
• キャプチャフォルダまたはファイルを指定してファイルをアップロードします。このオプションはワイルドカード (*) を使用して複数のファイルやフォルダを選択することをサポートします。
• Docker バージョンを Docker Hub で提供しており、依存関係を回避できます。
• デモやカンファレンス向けの難読化モード。
• 静的 GPS データを追加する機能。
• 各 AP の管理フレーム保護 (802.11w / PMF) の状態を報告します。RSN 機能からビット単位で読み取った mfpc (対応) および mfpr (必須) フラグと、それらから導出される pmf 状態 (Required、オプションの場合は Capable、または Disabled) を AP テーブルに保存します。
• 各 AP がアドバタイズする高速ローミングおよび管理サポートを検出します。802.11r Fast BSS Transition (ft_80211r、mobility_domain_id 付き)、802.11k Radio Resource Measurement / 近隣レポート (rrm_80211k)、802.11v BSS Transition Management (bss_transition_80211v)。
• マルチ BSSID セット (mbssid、max_bssid_indicator 付き) およびチャネルスイッチアナウンスメント (csa、ターゲットチャネル csa_new_channel 付き) をアドバタイズするアクセスポイントにフラグを立てます。
• クローク（非表示）された SSID を Probe Response および (Re)Association Request から明らかにし、ビーコンで隠されている場合でも AP 名を補完します（ssid_revealed はこの方法で学習された名前を示します）。

インストール

DockerHub から（推奨）``` bash

docker pull r4ulcl/wifi_db

### 手動インストール

#### Debianベースのシステム (Ubuntu, Kali, Parrot など)

依存関係:

- python3
- python3-pip
- tshark
- hcxtools``` bash
sudo apt install tshark
sudo apt install python3 python3-pip

sudo apt install pkg-config libcurl4-openssl-dev libssl-dev zlib1g-dev make gcc


git clone https://github.com/ZerBea/hcxtools.git
cd hcxtools
make 
sudo make install
cd ..

インストール（仮想環境の使用）``` bash

Download repo

git clone https://github.com/r4ulcl/wifi_db cd wifi_db

Create and activate a venv

sudo apt update ; sudo apt install python3-venv python3 -m venv wifi_db_env source wifi_db_env/bin/activate

Install dependencies

pip3 install -r requirements.txt

> venvは新しいシェルごとにアクティブ化する必要があります（`source wifi_db_env/bin/activate`）\
> `wifi_db.py`を実行する前に。終了するには`deactivate`を使用してください。

#### Arch

Dependencies:

- python3 
- python3-pip
- tshark
- hcxtools``` bash
sudo pacman -S wireshark-qt
sudo pacman -S python-pip python

git clone https://github.com/ZerBea/hcxtools.git
cd hcxtools
make 
sudo make install
cd ..

インストール (仮想環境を使用)``` bash

Download repo

git clone https://github.com/r4ulcl/wifi_db cd wifi_db

Create and activate a venv

python3 -m venv wifi_db_env source wifi_db_env/bin/activate

Install dependencies

pip3 install -r requirements.txt

> The venv は新しいシェルを開くたびに有効化する必要があります（`source wifi_db_env/bin/activate`）。終了するには `deactivate` を使用します。



## 使用方法

### [WiFiChallenge Lab](https://lab.wifichallenge.com/) での使用例

- https://r4ulcl.com/posts/wifi_db-in-wifichallenge-lab/

### airodump-ng によるスキャン

airodump-ng を実行し、出力を -w で保存します:``` bash
sudo airodump-ng wlan0mon -w scan --manufacturer --wps --gpsd

Dockerを使用してSQLiteデータベースを作成する``` bash

#Folder with captures CAPTURESFOLDER=/home/user/wifi

Output database

touch db.SQLITE chmod a+rw db.SQLITE

docker run -t -v $PWD/db.SQLITE:/app/db.SQLITE -v $CAPTURESFOLDER:/captures/ r4ulcl/wifi_db

- `-v $PWD/db.SQLITE:/app/db.SQLITE`: 現在のフォルダの db.SQLITE ファイルに出力を保存する
- `-v $CAPTURESFOLDER:/captures/`: キャプチャのあるフォルダを Docker と共有する

![usage docker](https://assets.kitploit.com/production/public/readmes/5785/7f0cc15851782e919c9d3d59c3135dab4c0a428ba7a51c7110bc75ff4c02520c.png)



### 手動インストールを使用して SQLite データベースを作成する