Modelo de seguridad

Cómo protege WindowsHelper su PC y su teléfono, qué criptografía utilizamos y contra qué no nos defendemos explícitamente. Última actualización: 2026-04-25.

Ciclo de vida del código de emparejamiento

El código de emparejamiento es el secreto compartido de donde se derivan todas las demás operaciones criptográficas. El 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 generados a través de RNG criptográficamente seguros.
• Alfabeto de 32 caracteres × 8 posiciones ≈ 1,1 billones de combinaciones. Excluye I/O/0/1 para evitar ambigüedad visual, no importancia para la seguridad: el espacio de código es lo suficientemente denso como para que una ventana de fuerza bruta de 5 minutos con límites de velocidad de Firestore no sea factible.
• Nunca escrito en Firestore por ninguna de las partes. Sólo el documento de la sesión de ESPERA lleva pairingCode; una vez emparejado, el código permanece exclusivamente en la memoria.
• Borrado de memoria al desconectar, volver a emparejar o cerrar la aplicación.

Criptografía

AES-256-GCM (confidencialidad de comando + integridad)

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

• Clave: 256 bits, derivado como SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Mientras tanto: 96 bits (12 bytes), generados recientemente por mensaje a través de Random.secure() por teléfono o RandomNumberGenerator en acompañante.
• Etiqueta de autenticación: 128 bits (16 bytes), añadidos al texto cifrado.
• Formato de cable: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Seguridad sin reutilización: Los nonces de 96 bits de un CSPRNG dan una probabilidad de colisión de la paradoja del cumpleaños de ~2⁻³² después de 2⁴⁸ mensajes, astronómicamente fuera del alcance de cualquier volumen de comando plausible.

HMAC-SHA256 (autenticidad del comando)

Cada comando también lleva una firma HMAC, por lo que un teléfono que no conoce el código de emparejamiento no puede inyectar comandos incluso si puede escribir en Firestore.

• Clave: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Separado de la clave de cifrado.
• Alcance del campo: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Las barras verticales son caracteres de barra vertical literales, no delimitadores: tres cadenas concatenadas.
• Orden de verificación: HMAC verificado antes descifrado. Los mensajes falsificados desperdician cero ciclos de CPU en primitivas criptográficas.

Modelo de amenaza

amenaza	Estado	Notas
Espionaje en la red local	mitigado	El texto cifrado AES-GCM es opaco para los observadores MITM.
Escuchador en servidores Firestore	mitigado	Google sees AESGCM:... blobs, not commands.
Atacante que puede escribir en Firestore pero no conoce el código	mitigado	La verificación HMAC falla; El compañero registra el rechazo + rechaza la ejecución.
Atacante que descifró o suplantó el código de emparejamiento	Residual	Pueden emitir comandos como si fueran el usuario. Mitigación: rote el código desde el menú de la bandeja.
Reproducción de un comando grabado	Residual	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Atacante no autenticado en modo LAN	mitigado	El protocolo de enlace del par WebSocket valida el código; HMAC + AES controla cada comando posterior.
Teléfono comprometido con clave de emparejamiento robada	Residual	Indistinguible de "el propio usuario". Mitigación: límite de velocidad (10 cmd/min) + confirmación de comando destructivo requiere un clic en el lado de la PC.
Comando mal escrito desde la aplicación del teléfono	mitigado	La lista de permitidos del lado del teléfono bloquea prefijos no reconocidos; El prevuelo del lado acompañante bloquea comandos dirigidos a servicios inexistentes.
Comando destructivo ejecutado accidentalmente	mitigado	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Proceso de PowerShell bloqueado/descontrolado	mitigado	Un tiempo de espera de 5 minutos mata todo el árbol de procesos.
Companion .exe alterado entre la descarga y la ejecución	mitigado	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion estado sensible a la fuga de fallos	mitigado	Informes de fallos + reescrituras de errores de Firestore desinfectan %USERPROFILE% / %MACHINE% / %USER%.
Dispositivo robado, clave de emparejamiento del Registro persistente	Residual	Un atacante con acceso a disco + inicio de sesión podría leer el código persistente. La solución futura lo incluye con Windows DPAPI.

Fuera de alcance

Cosas que WindowsHelper hace explícitamente no defenderse de:

• Cuenta Windows comprometida corriendo el compañero. Asumimos que la PC del usuario es suya. Un atacante con administrador en la PC del usuario ya ganó.
• Binario de aplicación de teléfono comprometido. No firmamos compilaciones de Android/iOS contra manipulación más allá de lo que ofrece la tienda de aplicaciones de la plataforma.
• Adversarios a nivel estatal con los recursos para subvertir el Firestore de Google o la PKI de DigiCert. Este producto apunta a amenazas de nivel de consumo (niños de guiones, fisgones ocasionales, miembros de hogares descontentos) no a los gobiernos.
• Ataques de canal lateral en AES-GCM mediante análisis de potencia/EM. La compañera no es una tarjeta inteligente.

Divulgación

• Correo electrónico support@windowshelper.app con tema [security].
• Incluya los números de versión, los pasos de reproducción, el impacto y la solución ideal.
• Primera respuesta en 48 horas. Gravedad clasificada en una semana. Los problemas de alta gravedad se publican fuera de ciclo.
• Plazo de divulgación: 90 días desde el informe inicial, o antes de mutuo acuerdo.
• Actualmente no hay recompensas por errores pagadas: damos crédito a los reporteros en las notas de la versión (con permiso).