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.
Correu electrònic support@windowshelper.app amb tema [security]. Si us plau, no obriu els problemes públics de GitHub; doneu-nos una finestra per enviar una solució abans de la divulgació.
El codi d'aparellament és el secret compartit del qual deriva qualsevol altra operació criptogràfica. El cicle de vida complet:
[ El telèfon GENERA un codi aleatori de 8 caràcters ] ↓ [ El telèfon ESCRIU el codi + sessionId a Firestore, al document pc_connections ] ↓ [ El telèfon MOSTRA el codi a l'usuari a la pantalla ] ↓ [ L'usuari LLEGEIX el codi i l'escriu al camp d'entrada del Companion ] ↓ [ El Companion CONSULTA Firestore per trobar la sessió en espera que coincideix amb el codi ] ↓ [ Totes dues bandes DERIVEN les claus criptogràfiques de SHA-256(codi, sessionId) ] ↓ [ El codi ES QUEDA a la memòria de totes dues bandes; cap de les dues l'escriu a Firestore ] ↓ [ Desconnectar / tornar a vincular ESBORRA el codi de totes dues bandes ]
Cada comanda enviada per cable està xifrada amb AES-256-GCM, un mode de xifratge autenticat.
SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").Random.secure() al telèfon o RandomNumberGenerator al Companion.AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>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.
SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Separar de la clau de xifratge.HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Les canonades són caràcters de canalització literals, no delimitadors: tres cadenes concatenades.| 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 veu blocs AESGCM:..., no ordres. |
| Atacant que pot escriure a Firestore però no coneix el codi | Mitigat | La verificació HMAC falla; el Companion registra el rebuig i es nega a executar-ho. |
| 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 està lligat a l'HMAC; el Companion encara no aplica cap finestra de validesa. Una correcció futura hi afegirà una caducitat. |
| 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 permesos del mòbil bloqueja prefixos desconeguts; la comprovació prèvia del costat del Companion bloqueja ordres dirigides a serveis inexistents. |
| Comandament destructiu executat accidentalment | Mitigat | Una finestra al costat del Companion requereix un clic de l'usuari per aprovar Remove-Item, Format-Volume, reg delete, shutdown /r, etc. |
| Procés de PowerShell penjat / descontrolat | Mitigat | Cada ordre té un límit de temps: 5 minuts per defecte, 45 per a una solució llarga, 60 al límit dur — i s'atura tot l'arbre de processos. |
| Companion Manipulació .exe entre la baixada i l'execució | Mitigat | SHA-256 publicat a companion-version.json; els usuaris ho poden verificar. La signatura Authenticode està prevista abans del llançament. |
| 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 | Mitigat | El codi d'aparellament persistent està xifrat amb Windows DPAPI (per compte), de manera que no es pot llegir des d'un disc copiat o d'un altre compte de Windows. |
Coses contra les quals WindowsHelper no protegeix explícitament:
[security].