WaveDigger
Explorez les signaux sans fil pour découvrir leurs emplacements physiques. WaveDigger vous aide à trouver les points d'accès Wi-Fi par leur BSSID (adresse MAC) et les tours cellulaires (LTE et 5G NR) par leurs paramètres réseau. Développé avec Next.js, TypeScript et deck.gl pour une visualisation cartographique interactive.
Une version hébergée est disponible à l'adresse https://wavedigger.networksurvey.app.
Fonctionnalités
- Recherche par BSSID : Saisissez un BSSID pour trouver son emplacement approximatif
- Validation des entrées : Formatage et validation automatiques de la saisie du BSSID
- Formats pris en charge :
AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF, AABBCCDDEEFF
- Recherche de tours cellulaires : Recherchez des tours LTE (MCC, MNC, TAC, Cell ID) ou des tours 5G NR (MCC, MNC, TAC, NCI). Les recherches NR renvoient la cellule cible ainsi que les cellules NR environnantes du même cluster.
- Carte interactive : Visualisez les résultats sur une carte propulsée par deck.gl
- Historique de recherche : Suivez les recherches récentes pour un accès rapide
- Design adaptatif : Fonctionne sur ordinateurs de bureau et appareils mobiles
Remerciements
🙏 Ce projet ne serait pas possible sans le travail incroyable réalisé par l'équipe apple-corelocation-experiments.
WaveDigger est construit sur leurs recherches et leur rétro-ingénierie de l'API des services de localisation d'Apple. Plus précisément, nous utilisons :
- Leurs définitions protobuf pour l'API WLOC d'Apple
- La documentation des points de terminaison de l'API et des formats de requête/réponse
- La compréhension de l'encodage des coordonnées et du comportement de l'API
- Le préfixe d'octets initial requis pour les requêtes valides
Leur travail de compréhension et de documentation des services de localisation non documentés d'Apple a rendu possible l'existence de projets comme WaveDigger. Consultez leur dépôt pour la recherche originale et des outils supplémentaires pour travailler avec les services de localisation d'Apple.
Pour commencer
Prérequis
Installation
- Installez les dépendances :
- (Facultatif) Ajoutez un jeton Mapbox pour des tuiles cartographiques améliorées :
- Obtenez un jeton sur Mapbox
- Ajoutez-le à
.env.local :
NEXT_PUBLIC_MAPBOX_TOKEN=your_token_here
Lancer le serveur de développement
Ouvrez http://localhost:3000 pour voir l'application.
Détails techniques
Architecture
- Frontend : Next.js 15 avec TypeScript
- Visualisation cartographique : deck.gl avec react-map-gl
- Styles : Tailwind CSS
- API : Routes API Next.js
Véritable API WLOC d'Apple
L'application utilise la véritable API WLOC d'Apple pour interroger les emplacements des BSSID. Cette implémentation est basée sur les recherches et les définitions protobuf du projet apple-corelocation-experiments.
L'implémentation de l'API :
- Utilise protobuf pour communiquer avec les serveurs d'Apple
- Envoie des requêtes à
https://gs-loc.apple.com/clls/wloc
- Gère la conversion des coordonnées (Apple utilise int64 avec 8 décimales)
- Prend en charge les points de terminaison par défaut et pour la région Chine
Tester avec de vrais BSSID
Pour tester l'application :
- Trouvez un vrai BSSID Wi-Fi (adresse MAC) depuis votre routeur ou point d'accès
- Saisissez-le dans n'importe quel format pris en charge
- L'application interrogera la base de données d'Apple et affichera l'emplacement s'il est trouvé
Remarque : Tous les BSSID ne figurent pas dans la base de données d'Apple. Les points d'accès récemment déployés ou privés peuvent ne pas avoir de données de localisation.
Feuille de route des fonctionnalités
- Export des résultats : Téléchargez les résultats de recherche au format JSON/CSV
- Vue par cluster TAC : Parcourez toutes les tours d'un TAC sans avoir besoin d'un Cell ID ou d'un NCI spécifique
Licence
WaveDigger est distribué sous la GNU Affero General Public License v3.0. Si vous exécutez une version modifiée de ce logiciel en tant que service réseau, l'AGPL vous oblige à rendre votre code source modifié disponible aux utilisateurs de ce service.
christianrowlands/wavedigger
