
パッシブデバイストラッカー (Android)TrackEm Mobileは、OSINT、レッドチーム運用、ワイヤレス研究向けに設計されたリアルタイムのパッシブWi-Fi + Bluetooth LEプローブ要求スキャナです。Wi-Fiネットワーク名を能動的にブロードキャストしているクライアントデバイス(スマートフォン、ノートPC、IoT)をリスンします。
Android向けのパッシブWi-Fi + Bluetooth LEオブザーバー。 TrackEmは、周辺のデバイスがすでにブロードキャストしているもの — Wi-Fiプローブリクエスト、 BLEアドバタイズメント、可視アクセスポイント — をリッスンし、周囲の無線をライブでフィルタ可能な インベントリに変換します。無線リサーチ、RFサイトサーベイ、 レッドチームの偵察、そして干渉するのではなく観測したいOSINT作業向けに構築されています。
TrackEmはWi-FiやBluetoothのフレームを一切送信しません。 これはオブザーバーです:プローブ リクエスト、アソシエーションフレーム、デアソシエーション、フレームインジェクションは行いません。詳細は TrackEmが行わないことを参照してください。
パッケージ: com.veteranop.trackem · ライセンス: MIT · Android 7.0+ (API 24)
TrackEmはホーム画面から3つのスキャンモードを実行します:
| モード | 観測対象 | 典型的な用途 |
|---|---|---|
| モバイルデバイス | スマートフォン、ノートPC、腕時計、IoTからのWi-FiプローブリクエストとBLEアドバタイズメント | プレゼンス検出、デバイス数カウント、プローブリクエストのリサーチ |
| Bluetooth LE | BLEアドバタイザーのみ(Wi-Fi無線は不要) | ビーコン / トラッカー / BLEデバイスのサーベイ |
| Wi-Fiアクセスポイント | 可視AP(SSID、BSSID、RSSI)、およびプラットフォームが報告する場合は関連付けられたクライアント | サイトサーベイ、ローグAPの探索 |
api.maclookup.app)
とオプションのWiGLE検索のみで、どちらもMAC/BSSIDのみを送信します。アナリティクスについて、正直に: ご自身で
app/google-services.jsonを用意した場合、 Firebase Analyticsは3つのアプリレベルのイベント —app_opened、start_scan(スキャンモード付き)、device_renamed(ブール値のみ、MACは決して含まない) — を記録します。観測したデバイスの 識別子は一切送信されません。そのファイルがなければ、アプリはアナリティクスを無効にしてビルド・実行されます: 呼び出しはnullableであるため、Firebase設定の欠落が起動をクラッシュさせることは決してありません。
これはライセンスと期待の両方に関わるため、はっきりと述べます:
WifiManager.startScan())ことで、これにより静かな
デバイスが次のスキャンウィンドウに現れる機会がもう一度与えられます。そのボタンは
FORCE WI-FI RESCAN (10x) とラベル付けされており、それが行うのはそれだけです — 10回の再スキャンです。api.maclookup.appへの外部HTTPS呼び出しを行います。
観測したデバイスに関する情報はどこにも送信されません。アクティブな無線テストが必要な場合は、専用のハードウェアとツールを使用してください(その前に、ネットワークに対する書面による許可を取得してください)。
| 権限 | 理由 |
|---|---|
ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION | Android は、アプリに Wi-Fi スキャン結果や BLE スキャン結果を渡す前に位置情報の権限を要求します。これは OS の要件であり、TrackEm の設定ではありません。 |
ACCESS_BACKGROUND_LOCATION | 任意 — アプリがバックグラウンドにある間もスキャンを継続したい場合のみ。 |
BLUETOOTH_SCAN (neverForLocation) / BLUETOOTH_CONNECT | BLE のスキャンと周辺機器への接続。 |
ACCESS_WIFI_STATE / CHANGE_WIFI_STATE | スキャン結果の読み取り、Wi-Fi 再スキャンのトリガー。 |
INTERNET / ACCESS_NETWORK_STATE | ベンダールックアップ(maclookup.app)と任意の WiGLE ルックアップ。 |
位置情報はスキャン結果を解決するために使用され、(ハンティング/マップモードを使用する場合は)サンプルを地図上に配置するために使用されます。TrackEm はデバイス外のどこにも位置履歴を保存しません。
要件: Android Studio(または SDK + JDK 17 のみ)、Android SDK platform 34。
git clone https://github.com/veteranop/trackem.git
cd trackem
maclookup.app の API キーはこのリポジトリには含まれていません(以前のコミットでハードコードされていましたが、その後ローテーションされ、履歴からも削除されています)。ご自身のキーを用意してください — local.properties(gitignore 対象)に記述するか、
sdk.dir=/path/to/Android/Sdk
MACLOOKUP_API_KEY=your-key-from-maclookup.app
…または CI 用の環境変数で指定します:
export MACLOOKUP_API_KEY=...
値は BuildConfig.MACLOOKUP_API_KEY として注入されます。キーが設定されていなくてもアプリは
ビルドおよび実行できます — ベンダールックアップは単にスキップされます。
app/google-services.json は Firebase API キーを含むため、gitignore されています。Firebase Analytics を
利用したい場合は、Firebase コンソールでパッケージ com.veteranop.trackem 用の独自の Android アプリエントリを作成し、
生成された google-services.json を app/ に配置してください。
このファイルがない場合、Google Services Gradle プラグインは適用されず、アプリは Firebase なしでビルドされます。
./gradlew :app:assembleDebug # debug APK
./gradlew :app:test # JVM unit tests
デバッグビルドは adb install -r app/build/outputs/apk/debug/app-debug.apk でインストールします。
古いビルドをインストールする場合 アプリケーションIDは現在
com.veteranop.trackem(以前はcom.example.trackemmobile)であるため、古いコピーを置き換えるのではなく、並行してインストールされます。 混乱を避けるため、古いものをアンインストールしてください。
このリポジトリの履歴では2つの認証情報が問題を引き起こしました。現在はどちらも同じ方法で扱われています:
| シークレット | 現在の保存場所 |
|---|---|
MACLOOKUP_API_KEY | local.properties / CIシークレット → BuildConfig.MACLOOKUP_API_KEY |
| Firebase APIキー | app/google-services.json、gitignore対象、開発者/CIごとに生成 |
.gitignore は google-services.json、.kotlin/、.gradle/、*.apk/*.aab、および
キーストアをブロックします。このリポジトリをフォークする場合は、両方のキーを自身の用途のためにローテーションしてください — 古い値は
公開されており、漏洩済みとして扱う必要があります。
BuildConfig フィールドは保管庫ではないことに注意してください。APKにコンパイルされ、抽出可能です。
レート制限されたMACルックアップキーであれば許容できるトレードオフですが、価値の高いものは
そこに置かないでください。
app/src/main/java/com/veteranop/trackem/
├── MainActivity.kt scan modes, device lists, API-key menu
├── DeviceScanner.kt Wi-Fi + BLE scanning, fingerprinting, vendor lookup
├── DetailActivity.kt single-device view, rescan, BLE connect
├── MapActivity.kt Wi-Fi AP map (WiGLE)
├── DeviceFingerprint.kt device model + RHID grouping
├── ui/hunting/ hunting mode (Compose + Maps)
└── utils/, data/ location helper, RSSI samples
無線トラフィックの傍受は、あなたがいる場所によって規制が異なり、たとえ聞いているだけでも、同意していない人に対してこのようなツールを使用することは違法となる場合があります。TrackEm は研究、教育、サイト調査、および許可されたセキュリティテストのために公開されています。それを使って行うことについての権限を有する責任はあなたにあります。作者は悪用に対して一切の責任を負いません — LICENSE を参照してください。
MIT — LICENSE を参照してください。