Modèle de sécurité

Comment WindowsHelper protège votre PC et votre téléphone, quelle cryptographie nous utilisons et contre quoi nous ne nous défendons pas explicitement. Dernière mise à jour : 2026-04-25.

Cycle de vie du code d'appariement

Le code d'appariement est le secret partagé dont découlent toutes les autres opérations de cryptographie. Le cycle de vie complet :

[ Le téléphone GÉNÈRE un code aléatoire de 8 caractères ]
   ↓
[ Le téléphone ÉCRIT le code + sessionId dans Firestore, dans le document pc_connections ]
   ↓
[ Le téléphone AFFICHE le code à l'utilisateur à l'écran ]
   ↓
[ L'utilisateur LIT le code et le saisit dans le champ du Companion ]
   ↓
[ Le Companion INTERROGE Firestore pour trouver la session en attente correspondant au code ]
   ↓
[ Les deux côtés DÉRIVENT les clés de chiffrement de SHA-256(code, sessionId) ]
   ↓
[ Le code RESTE en mémoire des deux côtés ; aucun des deux ne l'écrit dans Firestore ]
   ↓
[ La déconnexion / le réappairage EFFACE le code des deux côtés ]

• Aléatoire : codes générés via des RNG cryptographiquement sécurisés.
• Alphabet de 30 caractères × 8 positions ≈ 656 milliards de combinaisons. Exclut I, L, O, Z, 0 et 1 pour éviter l'ambiguïté visuelle, non pour des raisons de sécurité — l'espace des codes est assez dense pour qu'une fenêtre de force brute de 10 minutes, avec les limites de débit de Firestore, soit irréalisable.
• Conservé chiffré sur ce PC. Le Companion enregistre le code dans le Registre de votre compte Windows, chiffré avec DPAPI, afin de pouvoir se reconnecter après un redémarrage.
• Effacé quand vous vous déconnectez en effaçant la session, changez de code ou désinstallez. Fermer l'application le conserve, pour que le Companion puisse se reconnecter.

Cryptographie

AES-256-GCM (confidentialité des commandes + intégrité)

Chaque commande envoyée par fil est cryptée avec AES-256-GCM, un mode de cryptage authentifié.

• Clé : 256 bits, dérivés comme SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce : 96 bits (12 octets), générés fraîchement par message via Random.secure() au téléphone ou RandomNumberGenerator sur le Companion.
• Balise d'authentification : 128 bits (16 octets), ajoutés au texte chiffré.
• Format du fil : AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Sécurité de non-réutilisation du nonce : les nonces de 96 bits issus d'un CSPRNG maintiennent la probabilité de collision du paradoxe des anniversaires autour de 2⁻³² sur 2³² messages avec une même clé de session — la limite standard pour des nonces GCM aléatoires, et bien au-delà de tout volume de commandes plausible.

HMAC-SHA256 (authenticité de la commande)

Chaque commande porte également une signature HMAC, de sorte qu'un téléphone qui ne connaît pas le code d'appairage ne peut pas injecter de commandes même s'il peut écrire sur Firestore.

• Clé : 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Séparé de la clé de cryptage.
• Portée du champ : HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Les barres verticales sont des caractères de barre verticale littéraux, et non des délimiteurs : trois chaînes concaténées.
• Ordre de vérification : le HMAC est vérifié avant le déchiffrement. Les messages falsifiés ne gaspillent aucun cycle CPU en opérations cryptographiques.

Modèle de menace

Menace	Statut	Remarques
Écoute clandestine sur le réseau local	Atténué	Le texte chiffré AES-GCM est opaque pour les observateurs du MITM.
Écoute clandestine sur les serveurs Firestore	Atténué	Google voit des blocs AESGCM:..., pas des commandes.
Attaquant capable d'écrire sur Firestore mais ne connaissant pas le code	Atténué	La vérification HMAC échoue ; le Companion journalise le rejet et refuse l'exécution.
Attaquant qui a piraté/hameçonné le code d'association	Résiduel	Ils peuvent émettre des commandes comme s'ils étaient l'utilisateur. Atténuation : faites pivoter le code à partir du menu de la barre d'état.
Relecture d'une commande enregistrée	Résiduel	sentAtMillis est lié au HMAC ; le Companion n'impose pas encore de fenêtre de validité. Un correctif à venir ajoutera une expiration.
Attaquant non authentifié en mode LAN	Atténué	La poignée de main de la paire WebSocket valide le code ; HMAC + AES gate chaque commande suivante.
Téléphone compromis avec clé d'appairage volée	Résiduel	Impossible à distinguer de « l’utilisateur lui-même ». Atténuation : limite de débit (10 cmd/min) + confirmation de commande destructrice nécessite un clic côté PC.
Commande mal saisie depuis l'application téléphonique	Atténué	La liste d'autorisation côté téléphone bloque les préfixes inconnus ; la vérification préalable côté Companion bloque les commandes visant des services inexistants.
Commande destructrice exécutée accidentellement	Atténué	Une fenêtre côté Companion exige un clic de l'utilisateur pour approuver Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Processus PowerShell bloqué / en fuite	Atténué	Chaque commande a une limite de temps — 5 minutes par défaut, 45 pour une réparation longue, 60 au plafond dur — et tout l'arbre des processus est tué.
Companion .exe falsifié entre le téléchargement et l'exécution	Atténué	SHA-256 publié dans companion-version.json ; les utilisateurs peuvent le vérifier. La signature Authenticode est prévue avant le lancement.
Companion état sensible en cas de fuite en cas de crash	Atténué	Rapports d'erreur + réécritures d'erreurs Firestore %USERPROFILE% / %MACHINE% / %USER%.
Appareil volé, clé de couplage de registre persistante	Atténué	Le code d'association persistant est chiffré avec Windows DPAPI (par compte), il ne peut donc pas être lu à partir d'un disque copié ou d'un autre compte Windows.

Hors de portée

Ce contre quoi WindowsHelper ne protège pas, explicitement :

• Compte Windows compromis courir le compagnon. Nous supposons que le PC de l'utilisateur est le sien. Un attaquant disposant d'un administrateur sur le PC de l'utilisateur a déjà gagné.
• Binaire de l'application téléphonique compromise. Nous ne signons pas les builds Android/iOS contre toute falsification au-delà de ce que propose la boutique d'applications de la plateforme.
• Adversaires de niveau étatique disposant des moyens de compromettre le Firestore de Google ou les autorités de certification qui fondent HTTPS. Ce produit vise les menaces de niveau grand public — script kiddies, curieux de passage, membres du foyer mécontents — et non les gouvernements.
• Attaques par canal auxiliaire sur AES-GCM via analyse de consommation ou électromagnétique. Le Companion n'est pas une carte à puce.

Divulgation

• Courriel support@windowshelper.app avec sujet [security].
• Veuillez inclure les numéros de version, les étapes de reproduction, l'impact et le correctif idéal.
• Nous visons une réponse sous 48 heures et une évaluation de la gravité sous une semaine. Les problèmes graves donnent lieu à une version hors cycle.
• Fenêtre de divulgation : 90 jours à compter du rapport initial, ou plus tôt d'un commun accord.
• Aucune prime de bug payante pour le moment – nous créditons les journalistes dans les notes de version (avec autorisation).