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í, ze kterého vychází každá další krypto operace. Celý životní cyklus:

[ Telefon VYTVOŘÍ náhodný osmiznakový kód ]
   ↓
[ Telefon ZAPÍŠE kód + sessionId do Firestore v dokumentu pc_connections ]
   ↓
[ Telefon ZOBRAZÍ kód uživateli na obrazovce ]
   ↓
[ Uživatel PŘEČTE kód a zadá ho do pole v Companionu ]
   ↓
[ Companion VYHLEDÁ ve Firestore čekající relaci odpovídající kódu ]
   ↓
[ Obě strany ODVODÍ šifrovací klíče z SHA-256(kód, sessionId) ]
   ↓
[ Kód ZŮSTÁVÁ v paměti na obou stranách; ani jedna ho nezapíše do Firestore ]
   ↓
[ Odpojení / nové spárování VYMAŽE kód na obou stranách ]

• Náhodné: kódy generované pomocí kryptograficky bezpečných RNG.
• Abeceda o 30 znacích × 8 pozic ≈ 656 miliard kombinací. Vynechává I, L, O, Z, 0 a 1 kvůli vizuální záměně, ne z bezpečnostních důvodů — prostor kódů je dost hustý na to, aby desetiminutové okno pro hrubou sílu bylo při limitech četnosti Firestore neproveditelné.
• Uložen šifrovaně v tomto počítači. Companion ukládá kód do registru vašeho účtu Windows, šifrovaný pomocí DPAPI, aby se po restartu mohl znovu připojit.
• Smaže se, když se odpojíte a vymažete relaci, změníte kód nebo odinstalujete. Zavření aplikace ho ponechá, aby se Companion mohl znovu připojit.

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 straně Companion.
• 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 nepoužití nonce znovu: 96bitové nonce z CSPRNG udrží pravděpodobnost kolize podle narozeninového paradoxu na přibližně 2⁻³² v rámci 2³² zpráv na jednom relačním klíči — to je standardní limit pro náhodné GCM nonce a je daleko za jakýmkoli myslitelným objemem 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.
• Pořadí ověření: HMAC se ověřuje před dešifrováním. Padělané zprávy nespotřebují ani jeden cyklus CPU na kryptografické operace.

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 vidí bloky AESGCM:..., nikoli příkazy.
Útočník, který může zapisovat do Firestore, ale nezná kód	Zmírněno	Ověření HMAC se nezdaří; Companion zaznamená odmítnutí a 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 je vázán na HMAC; Companion zatím nevynucuje okno platnosti. Budoucí oprava přidá dobu platnosti.
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 neznámé předpony; předletová kontrola na straně Companion blokuje příkazy mířící na neexistující služby.
Náhodně spuštěný destruktivní příkaz	Zmírněno	Okno na straně aplikace Companion vyžaduje kliknutí uživatele ke schválení Remove-Item, Format-Volume, reg delete, shutdown /r apod.
Zablokovaný / uniklý proces PowerShell	Zmírněno	Každý příkaz má časový strop — 5 minut ve výchozím stavu, 45 u dlouho běžící opravy, 60 na tvrdém stropu — a ukončí se celý strom procesů.
Companion Manipulace s příponou .exe mezi stažením a spuštěním	Zmírněno	SHA-256 zveřejněný v companion-version.json; uživatelé si ho mohou ověřit. Podpis Authenticode je naplánován před spuštěním.
Companion citlivý stav ú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, proti kterým WindowsHelper výslovně nechrání:

• 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 úrovni států s prostředky k prolomení Firestore od společnosti Google nebo certifikačních autorit, na kterých stojí HTTPS. Tento produkt míří na hrozby běžných uživatelů — začínající hackery, náhodné šmíráky, nespokojené členy domácnosti —, ne na vlády.
• Útoky postranními kanály na AES-GCM pomocí analýzy napájení / EM. Companion 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.
• Snažíme se odpovědět do 48 hodin a závažnost posoudit do týdne. Závažné problémy dostanou mimořádné vydání.
• 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).