Modello di sicurezza

In che modo WindowsHelper protegge il tuo PC e il tuo telefono, quale crittografia utilizziamo e da cosa non ci difendiamo esplicitamente. Ultimo aggiornamento: 25-04-2026.

Ciclo di vita del codice di abbinamento

Il codice di abbinamento è il segreto condiviso da cui deriva ogni altra operazione crittografica. L'intero ciclo di vita:

[ Il telefono GENERA un codice casuale di 8 caratteri ]
   ↓
[ Il telefono SCRIVE il codice + sessionId su Firestore, nel documento pc_connections ]
   ↓
[ Il telefono MOSTRA il codice all'utente sullo schermo ]
   ↓
[ L'utente LEGGE il codice e lo digita nel campo del Companion ]
   ↓
[ Il Companion INTERROGA Firestore per la sessione in attesa che corrisponde al codice ]
   ↓
[ Entrambi i lati DERIVANO le chiavi crittografiche da SHA-256(codice, sessionId) ]
   ↓
[ Il codice RESTA in memoria su entrambi i lati; nessuno dei due lo scrive su Firestore ]
   ↓
[ La disconnessione / il nuovo abbinamento CANCELLA il codice su entrambi i lati ]

• Casuale: codici generati tramite RNG crittograficamente sicuri.
• Alfabeto di 30 caratteri × 8 posizioni ≈ 656 miliardi di combinazioni. Esclude I, L, O, Z, 0 e 1 per evitare ambiguità visiva, non per motivi di sicurezza — lo spazio dei codici è abbastanza denso da rendere impraticabile una finestra di forza bruta di 10 minuti con i limiti di frequenza di Firestore.
• Conservato cifrato su questo PC. Companion salva il codice nel Registro del tuo account Windows, cifrato con DPAPI, per potersi ricollegare dopo un riavvio.
• Cancellato quando ti disconnetti e cancelli la sessione, cambi il codice o disinstalli. Chiudere l'app lo conserva, così Companion può ricollegarsi.

Crittografia

AES-256-GCM (riservatezza dei comandi + integrità)

Ogni comando inviato via cavo viene crittografato con AES-256-GCM, una modalità di crittografia autenticata.

• Chiave: 256 bit, derivati come SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce: 96 bit (12 byte), generati di recente per messaggio tramite Random.secure() al telefono o RandomNumberGenerator sul Companion.
• Etichetta di autenticazione: 128 bit (16 byte), aggiunti al testo cifrato.
• Formato filo: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Sicurezza contro il riutilizzo del nonce: i nonce da 96 bit generati da un CSPRNG mantengono la probabilità di collisione del paradosso del compleanno intorno a 2⁻³² su 2³² messaggi con una stessa chiave di sessione — il limite standard per i nonce GCM casuali, e ben oltre qualsiasi volume di comandi plausibile.

HMAC-SHA256 (autenticità del comando)

Ogni comando porta anche una firma HMAC, quindi un telefono che non conosce il codice di accoppiamento non può inviare comandi anche se può scrivere su Firestore.

• Chiave: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Separato dalla chiave di crittografia.
• Ambito del campo: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Le pipe sono caratteri pipe letterali, non delimitatori: tre stringhe concatenate.
• Ordine di verifica: l'HMAC viene verificato prima della decrittazione. I messaggi falsificati non sprecano nemmeno un ciclo di CPU in operazioni crittografiche.

Modello di minaccia

Minaccia	Stato	Note
Intercettatore della rete locale	Mitigato	Il testo cifrato AES-GCM è opaco per gli osservatori MITM.
Intercettatore sui server Firestore	Mitigato	Google vede blocchi AESGCM:..., non comandi.
Aggressore che può scrivere su Firestore ma non conosce il codice	Mitigato	La verifica HMAC fallisce; Companion registra il rifiuto e non esegue il comando.
Aggressore che ha violato/phishing il codice di accoppiamento	Residuo	Possono impartire comandi come se fossero l'utente. Mitigazione: ruotare il codice dal menu della barra delle applicazioni.
Riproduzione di un comando registrato	Residuo	sentAtMillis è legato all'HMAC; il Companion non impone ancora una finestra di validità. Una correzione futura aggiungerà una scadenza.
Aggressore non autenticato in modalità LAN	Mitigato	L'handshake della coppia WebSocket convalida il codice; HMAC + AES gate ogni comando successivo.
Telefono compromesso con chiave di accoppiamento rubata	Residuo	Indistinguibile da "l'utente stesso". Mitigazione: il limite di velocità (10 cmd/min) + la conferma del comando distruttivo richiedono un clic dal lato PC.
Comando digitato in modo errato dall'app del telefono	Mitigato	L'elenco di autorizzazione sul telefono blocca i prefissi sconosciuti; il controllo preliminare sul lato Companion blocca i comandi diretti a servizi inesistenti.
Comando distruttivo eseguito accidentalmente	Mitigato	Una finestra sul lato Companion richiede un clic dell'utente per approvare Remove-Item, Format-Volume, reg delete, shutdown /r, ecc.
Processo PowerShell bloccato/incontrollato	Mitigato	Ogni comando ha un limite di tempo — 5 minuti per impostazione predefinita, 45 per una correzione lunga, 60 al tetto rigido — e viene terminato l'intero albero dei processi.
Companion Manomissione del file .exe tra il download e l'esecuzione	Mitigato	SHA-256 pubblicato in companion-version.json; gli utenti possono verificarlo. La firma Authenticode è prevista prima del lancio.
Companion arresto anomalo che perde lo stato sensibile	Mitigato	Report sugli arresti anomali + ripristini degli errori di Firestore disinfettati %USERPROFILE% / %MACHINE% / %USER%.
Dispositivo rubato, chiave di accoppiamento del registro persistente	Mitigato	Il codice di accoppiamento persistente è crittografato con Windows DPAPI (per account), quindi non può essere letto da un disco copiato o da un account Windows diverso.

Fuori portata

Cose da cui WindowsHelper esplicitamente non protegge:

• Account Windows compromesso correre il compagno. Presumiamo che il PC dell'utente sia il suo. Un utente malintenzionato con amministratore sul PC dell'utente ha già vinto.
• Binario dell'app del telefono compromesso. Non firmiamo le build Android/iOS contro la manomissione oltre a quanto fornito dall'app store della piattaforma.
• Avversari a livello statale con le risorse per violare il Firestore di Google o le autorità di certificazione su cui poggia HTTPS. Questo prodotto è pensato per minacce di livello domestico — script kiddie, curiosi occasionali, familiari scontenti — non per i governi.
• Attacchi side-channel su AES-GCM tramite analisi del consumo o elettromagnetica. Companion non è una smartcard.

Divulgazione

• E-mail support@windowshelper.app con soggetto [security].
• Includi i numeri di versione, i passaggi di riproduzione, l'impatto e la soluzione ideale.
• Puntiamo a rispondere entro 48 ore e a valutarne la gravità entro una settimana. I problemi gravi ricevono un rilascio fuori ciclo.
• Finestra di divulgazione: 90 giorni dalla segnalazione iniziale, o prima di comune accordo.
• Al momento non è prevista alcuna ricompensa per i bug a pagamento: accreditiamo i giornalisti nelle note di rilascio (con il permesso).