Modelo de Seguridade

Como WindowsHelper protexe o teu PC e o teu teléfono, que criptografía usamos e contra o que non defendemos explícitamente. Última actualización: 25-04-2026.

Ciclo de vida do código de emparejamento

O código de emparellamento é o segredo compartido calquera outra operación criptográfica derivada. O ciclo de vida completo:

[ 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 ]

• Aleatorio: códigos xerados mediante RNG criptográficamente seguros.
• Alfabeto de 32 caracteres × 8 posicións ≈ 1,1 billóns de combinacións. Exclúe I/O/0/1 para evitar a ambigüidade visual, non a importancia da seguridade: o espazo de código é o suficientemente denso como para que non sexa viable unha xanela de forza bruta de 5 minutos con límites de velocidade de Firestore.
• Nunca escrito en Firestore por ningún lado. Só leva o documento da sesión WAITING pairingCode; unha vez emparellado, o código permanece exclusivamente na memoria.
• Limpeza en memoria ao desconectar, emparellar de novo ou pechar a aplicación.

Criptografía

AES-256-GCM (confidencialidade do comando + integridade)

Cada comando enviado por cable está cifrado con AES-256-GCM, un modo de cifrado autenticado.

• Clave: 256 bits, derivados como SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce: 96 bits (12 bytes), xerados recentemente por mensaxe a través de Random.secure() por teléfono ou RandomNumberGenerator en compañeira.
• Etiqueta de autenticación: 128 bits (16 bytes), engadidos ao texto cifrado.
• Formato de cable: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Seguridade sen reutilización: Os nonces de 96 bits dun CSPRNG dan unha probabilidade de colisión paradoxa de aniversario de ~2⁻³² despois de 2⁴⁸ mensaxes, astronómicamente fóra do alcance de calquera volume de comando plausible.

HMAC-SHA256 (autenticidade do comando)

Cada comando tamén leva unha sinatura HMAC polo que un teléfono que non coñece o código de sincronización non pode inxectar comandos aínda que poida escribir en Firestore.

• Clave: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Separado da clave de cifrado.
• Ámbito de campo: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). As canalizacións son caracteres literais, non delimitadores: tres cadeas concatenadas.
• Orde de verificación: HMAC verificado antes descifrado. As mensaxes falsificadas malgastan cero ciclos de CPU en primitivas criptográficas.

Modelo de ameaza

Ameaza	Estado	Notas
Escoita na rede local	Atenuado	O texto cifrado AES-GCM é opaco para os observadores do MITM.
Eavesdropper nos servidores Firestore	Atenuado	Google sees AESGCM:... blobs, not commands.
Atacante que pode escribir en Firestore pero non coñece o código	Atenuado	A verificación HMAC falla; o compañeiro rexistra o rexeitamento + rexeita a execución.
Atacante que descifrau/suplantou o código de vinculación	Residual	Poden emitir comandos coma se fosen o usuario. Mitigación: xira o código desde o menú da bandexa.
Reprodución dun comando gravado	Residual	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Atacante non autenticado en modo LAN	Atenuado	O enlace de par de WebSocket valida o código; Porta HMAC + AES cada comando posterior.
Teléfono comprometido coa chave de sincronización roubada	Residual	Indistinguible de "o propio usuario". Mitigación: límite de velocidade (10 cmd/min) + a confirmación do comando destrutivo require un clic no lado do PC.
Comando mal escrito da aplicación do teléfono	Atenuado	A lista de permitidos do lado do teléfono bloquea os prefixos non recoñecidos; comandos de bloques previos ao voo do acompañante dirixidos a servizos inexistentes.
O comando destrutivo execútase accidentalmente	Atenuado	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Proceso de PowerShell suspendido / desbocado	Atenuado	Un duro tempo de espera de 5 minutos mata toda a árbore do proceso.
Companion Manipulación .exe entre a descarga e a execución	Atenuado	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Estado sensible de fuga de Companion fallo	Atenuado	Informes de fallos + desinfeccións de erros de Firestore %USERPROFILE% / %MACHINE% / %USER%.
Dispositivo roubado, clave de sincronización do rexistro persistente	Atenuado	O código de sincronización persistente está cifrado con Windows DPAPI (por conta), polo que non se pode ler desde un disco copiado ou dunha conta Windows diferente.

Fóra do alcance

Cousas que fai WindowsHelper explícitamente non defender contra:

• Conta Windows comprometida correndo o compañeiro. Supoñemos que a PC do usuario é a súa. Xa gañou un atacante con administrador no PC do usuario.
• Binario da aplicación de teléfono comprometida. Non asinamos compilacións de Android/iOS contra as manipulacións máis aló do que ofrece a tenda de aplicacións da plataforma.
• Adversarios a nivel estatal cos recursos para subverter a PKI de Google Firestore ou DigiCert. Este produto diríxese a ameazas de calidade para o consumidor: nenos guionistas, fisgones ocasionais, membros descontentos da casa, non aos gobernos.
• Ataques de canle lateral en AES-GCM mediante análise de potencia/EM. O acompañante non é unha tarxeta intelixente.

Divulgación

• Correo electrónico support@windowshelper.app con tema [security].
• Inclúe os números de versión, os pasos de reprodución, o impacto e a solución ideal.
• Primeira resposta en 48 horas. Gravidade clasificada nunha semana. Os problemas de alta gravidade obteñen unha versión fóra do ciclo.
• Ventá de divulgación: 90 días desde o informe inicial, ou antes de mutuo acordo.
• Non hai ningunha recompensa por erros de pago actualmente: acreditamos aos xornalistas nas notas de lanzamento (con permiso).