WaveDigger

Scava nei segnali wireless per scoprire le loro posizioni fisiche. WaveDigger ti aiuta a trovare i punti di accesso Wi-Fi tramite il loro BSSID (indirizzo MAC) e le torri cellulari (LTE e 5G NR) tramite i loro parametri di rete. Realizzato con Next.js, TypeScript e deck.gl per la visualizzazione interattiva su mappa.

Una versione ospitata è disponibile su https://wavedigger.networksurvey.app.

Funzionalità

• Ricerca BSSID: Inserisci un BSSID per trovare la sua posizione approssimativa
• Validazione Input: Formattazione e validazione automatica dell'input BSSID
  • Supporta i formati: AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF, AABBCCDDEEFF
• Ricerca Torri Cellulari: Cerca torri LTE (MCC, MNC, TAC, Cell ID) o torri 5G NR (MCC, MNC, TAC, NCI). Le ricerche NR restituiscono la cella target più le celle NR circostanti nello stesso cluster.
• Mappa Interattiva: Visualizza i risultati su una mappa basata su deck.gl
• Cronologia Ricerche: Tieni traccia delle ricerche recenti per un accesso rapido
• Design Responsive: Funziona su desktop e dispositivi mobili

Riconoscimenti

🙏 Questo progetto non sarebbe possibile senza l'incredibile lavoro svolto dal team di apple-corelocation-experiments.

WaveDigger è costruito sulla loro ricerca e reverse engineering dell'API dei servizi di localizzazione di Apple. Nello specifico, utilizziamo:

• Le loro definizioni protobuf per l'API WLOC di Apple
• La documentazione degli endpoint API e dei formati di richiesta/risposta
• La comprensione della codifica delle coordinate e del comportamento dell'API
• Il prefisso di byte iniziale richiesto per richieste valide

Il loro lavoro nel comprendere e documentare i servizi di localizzazione non documentati di Apple ha reso possibile l'esistenza di progetti come WaveDigger. Dai un'occhiata al loro repository per la ricerca originale e strumenti aggiuntivi per lavorare con i servizi di localizzazione di Apple.

Per Iniziare

Prerequisiti

• Node.js 24+ e npm

Installazione

1. Installa le dipendenze:

npm install

1. (Opzionale) Aggiungi un token Mapbox per tile mappa migliorati:
   • Ottieni un token da Mapbox
   • Aggiungilo a .env.local:
   root@kitploit:~

   NEXT_PUBLIC_MAPBOX_TOKEN=your_token_here
   

Avviare il Server di Sviluppo

npm run dev

Apri http://localhost:3000 per visualizzare l'applicazione.

Dettagli Tecnici

Architettura

• Frontend: Next.js 15 con TypeScript
• Visualizzazione Mappa: deck.gl con react-map-gl
• Styling: Tailwind CSS
• API: Route API di Next.js

API WLOC Reale di Apple

L'applicazione utilizza l'API WLOC reale di Apple per interrogare le posizioni dei BSSID. Questa implementazione si basa sulla ricerca e sulle definizioni protobuf del progetto apple-corelocation-experiments.

L'implementazione dell'API:

• Utilizza protobuf per la comunicazione con i server di Apple
• Invia richieste a https://gs-loc.apple.com/clls/wloc
• Gestisce la conversione delle coordinate (Apple utilizza int64 con 8 cifre decimali)
• Supporta sia gli endpoint predefiniti che quelli della regione Cina

Test con BSSID Reali

Per testare l'app:

1. Trova un BSSID Wi-Fi reale (indirizzo MAC) dal tuo router o punto di accesso
2. Inseriscilo in uno dei formati supportati
3. L'app interrogherà il database di Apple e mostrerà la posizione se trovata

Nota: Non tutti i BSSID sono nel database di Apple. I punti di accesso di nuova installazione o privati potrebbero non avere dati di localizzazione.

Roadmap delle Funzionalità

• Esportazione Risultati: Scarica i risultati della ricerca come JSON/CSV
• Vista cluster TAC: Sfoglia ogni torre in un TAC senza bisogno di uno specifico Cell ID o NCI

Licenza

WaveDigger è distribuito sotto la GNU Affero General Public License v3.0. Se esegui una versione modificata di questo software come servizio di rete, la AGPL richiede che tu renda disponibile il tuo codice sorgente modificato agli utenti di quel servizio.