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").
• Nonce: 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	Zmiernené	Trvalý párovací kód je šifrovaný pomocou Windows DPAPI (pre každý účet), takže ho nemožno prečítať zo skopírovaného disku alebo iného účtu Windows.

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).