Bezpečnostný model

Ako WindowsHelper chráni váš počítač + váš telefón, akú kryptografiu používame a proti čomu sa výslovne nebránime. Posledná aktualizácia: 25.04.2026.

Životný cyklus párovacieho kódu

Párovací kód je zdieľané tajomstvo každá ďalšia krypto operácia pochádza 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é prostredníctvom kryptograficky bezpečných RNG.
• 32-znaková abeceda × 8 pozícií ≈ 1,1 bilióna kombinácií. Vylučuje I/O/0/1, aby sa predišlo vizuálnej nejednoznačnosti, nie bezpečnostnému významu – kódový priestor je dostatočne hustý, že 5-minútové okno hrubou silou s limitmi rýchlosti Firestore je nemožné.
• Ani jedna strana nikdy nenapísala do Firestore. Prenáša iba reláciu WAITING doc pairingCode; po spárovaní zostane kód výlučne v pamäti.
• Vymazanie v pamäti pri odpojení, opätovnom spárovaní alebo zatvorení aplikácie.

Kryptografia

AES-256-GCM (dôvernosť príkazu + integrita)

Každý príkaz odoslaný po drôte je šifrovaný pomocou AES-256-GCM, režimu overeného šifrovania.

• kľúč: 256 bitov, odvodených ako SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nie: 96 bitov (12 bajtov), vygenerovaných čerstvo prostredníctvom správy Random.secure() na telefóne resp RandomNumberGenerator na spoločníka.
• Auth tag: 128 bitov (16 bajtov), pripojených k šifrovému textu.
• Formát drôtu: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Bezpečnosť pri jednorazovom použití: 96-bitové nonce z CSPRNG dávajú pravdepodobnosť kolízie s narodeninovým paradoxom ~2⁻³² po 2⁴⁸ správach – astronomicky mimo dosahu pre akýkoľvek prijateľný objem príkazov.

HMAC-SHA256 (pravosť príkazu)

Každý príkaz tiež nesie podpis HMAC, takže telefón, ktorý nepozná párovací kód, nemôže vkladať príkazy, aj keď môže zapisovať do Firestore.

• kľúč: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Oddelené od šifrovacieho kľúča.
• Rozsah poľa: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Zvislé čiary sú doslovné znaky zvislej čiary, nie oddeľovače – tri zreťazené reťazce.
• Overovacia objednávka: HMAC overené predtým dešifrovanie. Falošné správy strácajú nulové cykly CPU na kryptografických primitívoch.

Model ohrozenia

Hrozba	Stav	Poznámky
Odpočúvanie v lokálnej sieti	Zmiernené	Šifrový text AES-GCM je pre pozorovateľov MITM nepriehľadný.
Odpočúvanie na serveroch Firestore	Zmiernené	Google sees AESGCM:... blobs, not commands.
Útočník, ktorý môže písať do Firestore, ale nepozná kód	Zmiernené	Overenie HMAC zlyhá; spoločník zaznamená odmietnutie + odmietne vykonanie.
Útočník, ktorý prelomil / phishingom párovací kód	Reziduálny	Môžu zadávať príkazy, ako keby boli používateľom. Zmiernenie: otočte kód z ponuky zásobníka.
Prehratie nahraného príkazu	Reziduálny	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Neoverený útočník v režime LAN	Zmiernené	Párové handshake WebSocket overí kód; HMAC + AES brána každý nasledujúci príkaz.
Kompromitovaný telefón s ukradnutým párovacím kľúčom	Reziduálny	Na nerozoznanie od „samotného používateľa“. Zmiernenie: obmedzenie rýchlosti (10 cmd/min) + potvrdenie deštruktívneho príkazu vyžaduje kliknutie na strane počítača.
Nesprávne zadaný príkaz z aplikácie telefónu	Zmiernené	Zoznam povolených na strane telefónu blokuje nerozpoznané predvoľby; príkazy predletových blokov na strane spoločníka zamerané na neexistujúce služby.
Neúmyselné spustenie deštruktívneho príkazu	Zmiernené	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Zamrznutý/utečený proces PowerShell	Zmiernené	Tvrdý 5-minútový časový limit zabije celý procesný strom.
Companion Manipulácia s príponou .exe medzi stiahnutím a spustením	Zmiernené	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion stav citlivý na úniky	Zmiernené	Hlásenia o zlyhaní + spätné písanie chýb Firestore dezinfikujú %USERPROFILE% / %MACHINE% / %USER%.
Ukradnuté zariadenie, pretrvávajúci párovací kľúč databázy Registry	Reziduálny	Útočník s prístupom na disk + prihlásenie mohol prečítať pretrvávajúci kód. Budúca oprava to zabalí do Windows DPAPI.

Mimo rozsah

Veci, ktoré WindowsHelper výslovne robí nie brániť sa:

• Napadnutý účet Windows beh spoločníka. Predpokladáme, že počítač používateľa je jeho. Útočník s adminom na PC používateľa už vyhral.
• Ohrozená binárna aplikácia pre telefón. Nepodpisujeme zostavy Android/iOS proti neoprávneným zásahom nad rámec toho, čo poskytuje obchod s aplikáciami platformy.
• Protivníci na štátnej úrovni so zdrojmi na rozvrátenie Google Firestore alebo DigiCert PKI. Tento produkt sa zameriava na hrozby na úrovni spotrebiteľov – scenáristov, príležitostných čmuchov, nespokojných členov domácnosti – nie na vlády.
• Útoky cez bočný kanál na AES-GCM prostredníctvom analýzy napájania / EM. Spoločník nie je čipová karta.

Zverejnenie

• Email support@windowshelper.app s predmetom [security].
• Uveďte čísla verzií, kroky repro, vplyv a ideálnu opravu.
• Prvá odpoveď do 48 hodín. Triedovaná závažnosť do jedného týždňa. Problémy s vysokou závažnosťou sa vydávajú mimo cyklu.
• Termín zverejnenia: 90 dní od prvej správy alebo skôr po vzájomnej dohode.
• Momentálne nie je vyplatená odmena za chyby – v poznámkach k vydaniu pripisujeme zásluhy reportérom (s povolením).