Bezpečnostní model

Jak WindowsHelper chrání váš počítač + váš telefon, jakou kryptografii používáme a proti čemu se výslovně nebráníme. Poslední aktualizace: 25. 4. 2026.

Životní cyklus párovacího kódu

Párovací kód je sdílené tajemství každá další krypto operace vychází z. Celý životní cyklus:

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

• Náhodné: kódy generované pomocí kryptograficky bezpečných RNG.
• Abeceda 32 znaků × 8 pozic ≈ 1,1 bilionu kombinací. Vylučuje I/O/0/1, aby se zabránilo vizuální nejednoznačnosti, nikoli bezpečnostnímu významu – kódový prostor je dostatečně hustý, že 5minutové okno hrubou silou s limity rychlosti Firestore je neproveditelné.
• Ani jedna strana nikdy nepsala do Firestore. Přenáší pouze dokument WAITING session pairingCode; po spárování zůstane kód výhradně v paměti.
• Vymazání v paměti při odpojení, opětovném spárování nebo zavření aplikace.

Kryptografie

AES-256-GCM (důvěrnost příkazu + integrita)

Každý příkaz odeslaný po drátě je zašifrován pomocí AES-256-GCM, což je režim ověřeného šifrování.

• Klíč: 256 bitů, odvozených jako SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce: 96 bitů (12 bajtů), čerstvě generovaných na zprávu prostřednictvím Random.secure() na telefonu popř RandomNumberGenerator na společníka.
• Auth tag: 128 bitů (16 bajtů), připojených k šifrovanému textu.
• Formát drátu: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Bezpečnost při opětovném použití: 96bitové nonce z CSPRNG dávají pravděpodobnost kolize narozenin-paradoxu ~2⁻³² po 2⁴⁸ zprávách – astronomicky mimo dosah pro jakýkoli přijatelný objem příkazů.

HMAC-SHA256 (pravost příkazu)

Každý příkaz také nese podpis HMAC, takže telefon, který nezná párovací kód, nemůže vkládat příkazy, i když může zapisovat do Firestore.

• Klíč: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Oddělte od šifrovacího klíče.
• Rozsah pole: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Roury jsou doslovné svislé znaky, nikoli oddělovače – tři zřetězené řetězce.
• Ověřovací objednávka: HMAC ověřeno dříve dešifrování. Falešné zprávy plýtvají nulovými cykly CPU na kryptografických primitivech.

Model ohrožení

hrozba	Stav	Poznámky
Odposlech v místní síti	Zmírněno	Šifrovaný text AES-GCM je pro pozorovatele MITM neprůhledný.
Odposlech na serverech Firestore	Zmírněno	Google sees AESGCM:... blobs, not commands.
Útočník, který může zapisovat do Firestore, ale nezná kód	Zmírněno	Ověření HMAC se nezdaří; společník zaznamená odmítnutí + odmítne provedení.
Útočník, který prolomil / phishingem párovací kód	Zbytkový	Mohou vydávat příkazy, jako by byli uživatelem. Zmírnění: otočte kód z nabídky zásobníku.
Přehrání nahraného příkazu	Zbytkový	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Neověřený útočník v režimu LAN	Zmírněno	Párové handshake WebSocket ověří kód; HMAC + AES brána každý následující příkaz.
Kompromitovaný telefon s odcizeným párovacím klíčem	Zbytkový	K nerozeznání od „uživatelů samotných“. Zmírnění: omezení rychlosti (10 cmd/min) + potvrzení destruktivního příkazu vyžaduje kliknutí na straně PC.
Chybně zadaný příkaz z aplikace telefonu	Zmírněno	Seznam povolených na straně telefonu blokuje nerozpoznané předpony; Příkazy předletových bloků na straně společníka zaměřené na neexistující služby.
Náhodně spuštěný destruktivní příkaz	Zmírněno	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Zablokovaný / uniklý proces PowerShell	Zmírněno	Tvrdý 5minutový časový limit zabije celý strom procesu.
Companion Manipulace s příponou .exe mezi stažením a spuštěním	Zmírněno	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion citlivý stav úniku úniku	Zmírněno	Hlášení o selhání + zpětné zápisy o chybách Firestore jsou dezinfikovány %USERPROFILE% / %MACHINE% / %USER%.
Ukradené zařízení, přetrvávající klíč pro párování registru	Zmírněno	Trvalý párovací kód je zašifrován pomocí Windows DPAPI (pro každý účet), takže jej nelze přečíst ze zkopírovaného disku nebo jiného účtu Windows.

Mimo rozsah

Věci, které WindowsHelper explicitně dělá ne bránit se:

• Prolomený účet Windows běh společníka. Předpokládáme, že PC uživatele je jeho. Útočník s adminem na PC uživatele již vyhrál.
• Binární soubor kompromitované aplikace pro telefon. Nepodpisujeme sestavení Android/iOS proti neoprávněným zásahům nad rámec toho, co nabízí obchod s aplikacemi dané platformy.
• Protivníci na státní úrovni s prostředky k podvrácení Google Firestore nebo DigiCert PKI. Tento produkt se zaměřuje na hrozby na úrovni spotřebitelů – děti ze scénářů, příležitostné slídky, nespokojené členy domácnosti – nikoli na vlády.
• Útoky postranním kanálem na AES-GCM prostřednictvím analýzy napájení / EM. Společník není čipová karta.

Zveřejnění

• E-mail support@windowshelper.app s předmětem [security].
• Uveďte prosím čísla verzí, kroky opakování, dopad a ideální opravu.
• První odpověď do 48 hodin. Tříděná závažnost během jednoho týdne. Problémy s vysokou závažností jsou vydávány mimo cyklus.
• Zveřejňovací okno: 90 dní od první zprávy nebo dříve po vzájemné dohodě.
• Aktuálně žádná vyplacená odměna za chyby – v poznámkách k vydání připisujeme reportérům (se svolením).