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").
• Ningunha: 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	Residual	Un atacante con acceso ao disco + inicio de sesión podería ler o código persistente. A corrección futura engádese con Windows DPAPI.

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).