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 do que deriva calquera outra operación criptográfica. O ciclo de vida completo:

[ O teléfono XERA un código aleatorio de 8 caracteres ]
   ↓
[ O teléfono ESCRIBE o código + sessionId en Firestore, no documento pc_connections ]
   ↓
[ O teléfono MOSTRA o código ao usuario na pantalla ]
   ↓
[ O usuario LE o código e escríbeo no campo do Companion ]
   ↓
[ O Companion CONSULTA Firestore para atopar a sesión en espera que coincide co código ]
   ↓
[ Ambos os lados DERIVAN as claves criptográficas de SHA-256(código, sessionId) ]
   ↓
[ O código PERMANECE na memoria dos dous lados; ningún o escribe en Firestore ]
   ↓
[ Desconectar / vincular de novo BORRA o código nos dous lados ]

• Aleatorio: códigos xerados mediante RNG criptográficamente seguros.
• Alfabeto de 30 caracteres × 8 posicións ≈ 656 mil millóns de combinacións. Exclúe I, L, O, Z, 0 e 1 para evitar ambigüidade visual, non por seguridade: o espazo de códigos é abondo denso para que unha xanela de forza bruta de 10 minutos, cos límites de frecuencia de Firestore, sexa inviable.
• Gárdase cifrado neste PC. O Companion garda o código no rexistro da túa conta de Windows, cifrado con DPAPI, para poder conectarse de novo tras un reinicio.
• Bórrase cando desconectas e borras a sesión, cambias o código ou desinstalas. Pechar a aplicación consérvao, para que o Companion poida conectarse de novo.

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 no Companion.
• Etiqueta de autenticación: 128 bits (16 bytes), engadidos ao texto cifrado.
• Formato de cable: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Seguridade de non reutilización do nonce: os nonces de 96 bits dun CSPRNG manteñen a probabilidade de colisión do paradoxo do aniversario arredor de 2⁻³² ao longo de 2³² mensaxes cunha mesma clave de sesión — o límite estándar para nonces aleatorios de GCM, e moi por riba de calquera volume de ordes 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: o HMAC verifícase antes do descifrado. As mensaxes falsificadas non malgastan ningún ciclo de CPU en operacións 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 ve bloques AESGCM:..., non ordes.
Atacante que pode escribir en Firestore pero non coñece o código	Atenuado	A verificación HMAC falla; o Companion rexistra o rexeitamento e négase a executalo.
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 está ligado ao HMAC; o Companion aínda non aplica unha xanela de validez. Unha corrección futura engadirá unha caducidade.
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 móbil bloquea prefixos descoñecidos; a comprobación previa do lado do Companion bloquea ordes dirixidas a servizos inexistentes.
O comando destrutivo execútase accidentalmente	Atenuado	Unha xanela no lado do Companion require un clic do usuario para aprobar Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Proceso de PowerShell suspendido / desbocado	Atenuado	Cada orde ten un límite de tempo: 5 minutos por defecto, 45 para unha solución longa, 60 no tope duro — e mátase a árbore de procesos enteira.
Companion Manipulación .exe entre a descarga e a execución	Atenuado	SHA-256 publicado en companion-version.json; os usuarios poden comprobalo. A sinatura Authenticode está prevista antes do lanzamento.
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 contra as que WindowsHelper non protexe explicitamente:

• 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 de nivel estatal con recursos para vulnerar o Firestore de Google ou as autoridades de certificación que sosteñen HTTPS. Este produto pensa en ameazas de nivel doméstico — aprendices de pirata, curiosos ocasionais, familiares descontentos —, non en gobernos.
• Ataques de canle lateral a AES-GCM mediante análise de consumo ou electromagnética. O Companion 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.
• Procuramos responder en 48 horas e valorar a gravidade nunha semana. Os problemas graves reciben unha versión fóra do ciclo habitual.
• 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).