Veiligheidsmodel

Hoe WindowsHelper jou rekenaar + jou foon beskerm, watter kriptografie ons gebruik, en waarteen ons uitdruklik nie verdedig nie. Laas opgedateer: 2026-04-25.

Paring-kode lewensiklus

Die paringskode is die geheime gedeel elke ander kripto-bewerking is afkomstig van. Die volle lewensiklus:

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

• Willekeurig: kodes gegenereer via kriptografies veilige RNG'e.
• 32-kar alfabet × 8 posisies ≈ 1,1 triljoen kombinasies. Sluit I/O/0/1 uit om visuele dubbelsinnigheid te vermy, nie sekuriteitsbelangrikheid nie - die koderuimte is dig genoeg dat 'n 5-minute brute-force-venster met Firestore-tarieflimiete onuitvoerbaar is.
• Nooit aan weerskante aan Firestore geskryf nie. Slegs die WAG-sessie-dok. dra pairingCode; sodra dit gepaar is, bly die kode uitsluitlik in die geheue.
• In-geheue vee op ontkoppel, weer saambind, of program sluit.

Kriptografie

AES-256-GCM (bevelvertroulikheid + integriteit)

Elke opdrag wat oor die draad gestuur word, word geïnkripteer met AES-256-GCM, 'n geverifieerde-enkripsie-modus.

• Sleutel: 256 bisse, afgelei as SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nie een nie: 96 bisse (12 grepe), vars per boodskap gegenereer via Random.secure() op telefoon of RandomNumberGenerator op metgesel.
• Auth tag: 128 bisse (16 grepe), aangeheg aan die syferteks.
• Draadformaat: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Nie-hergebruik veiligheid: 96-bis nonses van 'n CSPRNG gee 'n verjaardag-paradoks botsing waarskynlikheid van ~2⁻³² na 2⁴⁸ boodskappe - astronomies buite bereik vir enige aanneemlike opdragvolume.

HMAC-SHA256 (bevel-egtheid)

Elke opdrag dra ook 'n HMAC-handtekening sodat 'n foon wat nie die saambindkode ken nie, nie opdragte kan inspuit nie, selfs al kan dit na Firestore skryf.

• Sleutel: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Skei van die enkripsiesleutel.
• Veld omvang: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Die pype is letterlike pypkarakters, nie afbakenings nie - drie aaneengeskakelde stringe.
• Verifikasiebestelling: HMAC geverifieer voor dekripsie. Vervalste boodskappe mors nul SVE-siklusse op kriptografiese primitiewe.

Bedreigingsmodel

Bedreiging	Status	Notas
Afluisteraar op die plaaslike netwerk	Versag	AES-GCM-syferteks is ondeursigtig vir MITM-waarnemers.
Afluister op Firestore-bedieners	Versag	Google sees AESGCM:... blobs, not commands.
Aanvaller wat aan Firestore kan skryf, maar nie die kode ken nie	Versag	HMAC-verifikasie misluk; metgesel teken die verwerping aan + weier uitvoering.
Aanvaller wat die paringskode gekraak / uitgeviss het	Oorblywende	Hulle kan opdragte uitreik asof hulle die gebruiker is. Versagting: draai die kode vanaf die skinkbordkieslys.
Herhaling van 'n opgeneemde opdrag	Oorblywende	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
LAN-modus ongeverifieerde aanvaller	Versag	WebSocket paar handdruk bekragtig die kode; HMAC + AES hek elke daaropvolgende opdrag.
Gekompromitteerde foon met gesteelde saambindsleutel	Oorblywende	Ononderskeibaar van "die gebruiker self." Versagting: tempolimiet (10 cmd/min) + vernietigende opdragbevestiging vereis PC-kantkliek.
Mistikte opdrag vanaf telefoontoepassing	Versag	Toelaatlys aan die foonkant blokkeer onherkende voorvoegsels; metgesel-kant voorvlug blokke opdragte wat nie-bestaande dienste teiken.
Vernietigende opdrag loop per ongeluk	Versag	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Gehang / weghol PowerShell-proses	Versag	Moeilike 5 minute-time-out maak die hele prosesboom dood.
Companion .exe peuter tussen aflaai en hardloop	Versag	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion omval wat sensitiewe toestand lek	Versag	Omvalverslae + Firestore-foutterugskrywings ontsmet %USERPROFILE% / %MACHINE% / %USER%.
Gesteelde toestel, volgehoue Register-paringsleutel	Oorblywende	'n Aanvaller met skyf + aanmeldtoegang kon die volgehoue kode lees. Toekomstige oplossing sluit dit toe met Windows DPAPI.

Buite omvang

Dinge wat WindowsHelper uitdruklik doen nie verdedig teen:

• Gekompromitteerde Windows rekening hardloop die metgesel. Ons neem aan die gebruiker se rekenaar is hulle s'n. 'n Aanvaller met admin op die gebruiker se rekenaar het reeds gewen.
• Gekompromitteerde telefoon-app binêre. Ons onderteken nie Android/iOS-geboue teen peuter verder as wat die platform se app-winkel bied nie.
• Teenstanders op staatsvlak met die hulpbronne om Google se Firestore of DigiCert se PKI te ondermyn. Hierdie produk teiken dreigemente van verbruikersgraad - skrifkiddies, toevallige snuffelaars, ontevrede huishoudingslede - nie regerings nie.
• Sykanaalaanvalle op AES-GCM via krag / EM-analise. Die metgesel is nie 'n slimkaart nie.

Openbaarmaking

• E-pos support@windowshelper.app met onderwerp [security].
• Sluit asseblief weergawenommers, repro-stappe, impak en ideale oplossing in.
• Eerste reaksie binne 48 uur. Triaged erns binne een week. Hoë erns kwessies kry 'n buite-siklus vrystelling.
• Openbaarmakingsvenster: 90 dae vanaf aanvanklike verslag, of vroeër volgens onderlinge ooreenkoms.
• Geen betaalde foutprys tans nie - ons krediteer verslaggewers in vrystellingsnotas (met toestemming).