Model de seguretat

Com WindowsHelper protegeix el vostre ordinador i el vostre telèfon, quina criptografia fem servir i contra què no defensem explícitament. Última actualització: 25-04-2026.

Cicle de vida del codi d'aparellament

El codi d'aparellament és el secret compartit qualsevol altra operació criptogràfica derivada. El cicle de vida complet:

[ Phone GENERATES random 8-char code ]
   ↓
[ Phone WRITES code + sessionId to Firestore in pc_connections doc ]
   ↓
[ Phone DISPLAYS code to user on screen ]
   ↓
[ User READS code, types it into companion's input field ]
   ↓
[ Companion QUERIES Firestore for waiting session matching the code ]
   ↓
[ Both sides DERIVE crypto keys from SHA-256(code, sessionId) ]
   ↓
[ Code STAYS in memory on both sides; never written to Firestore by either ]
   ↓
[ Disconnect / re-pair WIPES the code from both sides ]

• Aleatori: codis generats mitjançant RNG criptogràficament segurs.
• Alfabet de 32 caràcters × 8 posicions ≈ 1,1 bilions de combinacions. Exclou l'I/O/0/1 per evitar l'ambigüitat visual, no la importància de la seguretat: l'espai de codi és prou dens perquè no sigui factible una finestra de força bruta de 5 minuts amb límits de velocitat de Firestore.
• No s'ha escrit mai a Firestore per cap banda. Només porta el document de la sessió WAITING pairingCode; un cop emparellat, el codi roman exclusivament a la memòria.
• Esborrat a la memòria en desconnectar, tornar a emparellar o tancar l'aplicació.

Criptografia

AES-256-GCM (confidencialitat de comandaments + integritat)

Cada comanda enviada per cable està xifrada amb AES-256-GCM, un mode de xifratge autenticat.

• Clau: 256 bits, derivats com SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Ningú: 96 bits (12 bytes), generats recentment per missatge via Random.secure() al telèfon o RandomNumberGenerator en companyia.
• Etiqueta d'autorització: 128 bits (16 bytes), afegits al text xifrat.
• Format de cable: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Seguretat sense reutilització: Les noces de 96 bits d'un CSPRNG donen una probabilitat de col·lisió de paradoxa d'aniversari de ~2⁻³² després de 2⁴⁸ missatges, astronòmicament fora de l'abast de qualsevol volum d'ordres plausible.

HMAC-SHA256 (autenticitat de la comanda)

Cada comanda també porta una signatura HMAC, de manera que un telèfon que no conegui el codi de vinculació no pot injectar ordres encara que pugui escriure a Firestore.

• Clau: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Separar de la clau de xifratge.
• Àmbit de camp: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Les canonades són caràcters de canalització literals, no delimitadors: tres cadenes concatenades.
• Ordre de verificació: HMAC verificat abans desxifrat. Els missatges falsificats malgasten zero cicles de CPU en primitives criptogràfiques.

Model d'amenaça

Amenaça	Estat	Notes
Escolta a la xarxa local	Mitigat	El text xifrat AES-GCM és opac per als observadors MITM.
Escolta als servidors de Firestore	Mitigat	Google sees AESGCM:... blobs, not commands.
Atacant que pot escriure a Firestore però no coneix el codi	Mitigat	La verificació HMAC falla; El company registra el rebuig + rebutja l'execució.
Atacant que ha descobert/ha suplantat el codi d'aparellament	Residual	Poden emetre ordres com si fossin l'usuari. Mitigació: gireu el codi des del menú de la safata.
Repetició d'una ordre gravada	Residual	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Atacant no autenticat en mode LAN	Mitigat	WebSocket pair handshake valida el codi; HMAC + AES porta cada comanda posterior.
Telèfon compromès amb clau de vinculació robada	Residual	Indistingible de "el propi usuari". Mitigació: límit de velocitat (10 cmd/min) + confirmació de la comanda destructiva requereix un clic al costat de l'ordinador.
Comandament escrit incorrectament des de l'aplicació del telèfon	Mitigat	La llista de permisos del costat del telèfon bloqueja els prefixos no reconeguts; ordres de bloqueig previ al vol de l'acompanyant dirigides a serveis inexistents.
Comandament destructiu executat accidentalment	Mitigat	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Procés de PowerShell penjat / descontrolat	Mitigat	El temps d'espera de 5 minuts mata tot l'arbre del procés.
Companion Manipulació .exe entre la baixada i l'execució	Mitigat	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion estat sensible de fuga d'error	Mitigat	Informes d'error + desinfectació d'errors de Firestore %USERPROFILE% / %MACHINE% / %USER%.
Dispositiu robat, clau d'aparellament del registre persistent	Residual	Un atacant amb accés al disc + accés podria llegir el codi persistent. La correcció futura l'embolica amb Windows DPAPI.

Fora de l'abast

Coses que WindowsHelper fa explícitament no defensar-se de:

• Compte Windows compromès corrent el company. Suposem que l'ordinador de l'usuari és el seu. Un atacant amb administrador a l'ordinador de l'usuari ja ha guanyat.
• Binari de l'aplicació de telèfon compromès. No signem versions d'Android/iOS contra la manipulació més enllà del que ofereix la botiga d'aplicacions de la plataforma.
• Adversaris a nivell estatal amb els recursos per subvertir la PKI de Google Firestore o DigiCert. Aquest producte s'adreça a les amenaces de qualitat del consumidor: nens de guió, tafaners casuals, membres de la llar descontents, no governs.
• Atacs de canal lateral a AES-GCM mitjançant anàlisi de potència / EM. L'acompanyant no és una targeta intel·ligent.

Divulgació

• Correu electrònic support@windowshelper.app amb tema [security].
• Incloeu els números de versió, els passos de reproducció, l'impacte i la solució ideal.
• Primera resposta en 48 hores. Severitat triada en una setmana. Els problemes d'alta gravetat obtenen un llançament fora de cicle.
• Període de divulgació: 90 dies des de l'informe inicial, o abans de mutu acord.
• Actualment, no hi ha cap recompensa d'error pagada; acreditem els periodistes a les notes de llançament (amb permís).