Mudell tas-Sigurtà

Kif WindowsHelper tipproteġi l-PC tiegħek + it-telefon tiegħek, liema kriptografija nużaw, u kontra dak li ma niddefendux espliċitament. Aġġornata l-aħħar: 2026-04-25.

Ċiklu tal-ħajja tal-kodiċi ta' tqabbil

Il-kodiċi ta 'tqabbil huwa l- sigriet maqsum kull operazzjoni kripto oħra ġejja minn. Iċ-ċiklu tal-ħajja sħiħ:

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

• Bl-addoċċ: kodiċi ġġenerati permezz ta' RNGs kriptografikament sikuri.
• Alfabett 32-char × 8 pożizzjonijiet ≈ 1.1 triljun kombinazzjonijiet. Teskludi I/O/0/1 biex tiġi evitata ambigwità viżiva, mhux sinifikat tas-sigurtà — l-ispazju tal-kodiċi huwa dens biżżejjed li tieqa ta 'forza bruta ta' 5 minuti b'limiti tar-rata ta 'Firestore ma tkunx fattibbli.
• Qatt ma nkiteb lil Firestore minn kull naħa. Id-dokument tas-sessjoni ta' STENNIJA jġorr biss pairingCode; ladarba jkun imqabbad, il-kodiċi jibqa' fil-memorja esklussivament.
• Imsaħ fil-memorja meta tiskonnettja, terġa' tgħaqqad, jew tagħlaq l-app.

Kriptografija

AES-256-GCM (kunfidenzjalità tal-kmand + integrità)

Kull kmand mibgħut fuq il-wajer huwa encrypted b'AES-256-GCM, mod ta 'kodifikazzjoni awtentikata.

• Ċavetta: 256 bit, derivati bħala SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Xejn: 96 bit (12 bytes), iġġenerat frisk għal kull messaġġ permezz Random.secure() fuq it-telefon jew RandomNumberGenerator fuq kumpann.
• Tag ta' awtorizzazzjoni: 128 bit (16 bytes), mehmuża mal-ciphertext.
• Format tal-wajer: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Sigurtà li ma tużax mill-ġdid: Nonces ta' 96 bit minn CSPRNG jagħtu probabbiltà ta' kolliżjoni ta' paradoss ta' għeluq snin ta' ~2⁻³² wara messaġġi 2⁴⁸ — astronomikament ma jintlaħaqx għal kwalunkwe volum ta' kmand plawżibbli.

HMAC-SHA256 (awtentiċità tal-kmand)

Kull kmand iġorr ukoll firma HMAC u għalhekk telefon li ma jafx il-kodiċi ta' tqabbil ma jkunx jista' jinjetta kmandi anki jekk jista' jikteb lil Firestore.

• Ċavetta: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Issepara miċ-ċavetta tal-kriptaġġ.
• Ambitu tal-qasam: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Il-pajpijiet huma karattri tal-pajp litterali, mhux delimitaturi - tliet kordi konkatenati.
• Ordni ta' verifika: HMAC verifikat qabel dekriptaġġ. Messaġġi foloz jaħlu żero ċikli ta 'CPU fuq primitives kriptografiċi.

Mudell tat-theddida

Theddida	Status	Noti
Eavesdropper fuq in-netwerk lokali	Mitigati	It-test taċ-ċifra AES-GCM huwa opak għall-osservaturi tal-MITM.
Eavesdropper fuq servers Firestore	Mitigati	Google sees AESGCM:... blobs, not commands.
Attakkant li jista' jikteb lil Firestore iżda ma jafx il-kodiċi	Mitigati	Il-verifika tal-HMAC tfalli; kumpann jirreġistra r-rifjut + jirrifjuta l-eżekuzzjoni.
Attakkant li kkrekkja / phishing il-kodiċi tal-tqabbil	Residwu	Jistgħu joħorġu kmandi bħallikieku kienu l-utent. Mitigazzjoni: dawwar il-kodiċi mill-menu tat-trej.
Replay ta' kmand irreġistrat	Residwu	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Attakkant mhux awtentikat fil-modalità LAN	Mitigati	WebSocket par handshake jivvalida l-kodiċi; HMAC + AES gate kull kmand sussegwenti.
Telefown kompromess b'ċavetta ta' pairing misruqa	Residwu	Indistingwibbli minn "l-utent innifsu." Mitigazzjoni: limitu tar-rata (10 cmd/min) + konferma tal-kmand distruttiv teħtieġ ikklikkja fuq il-ġenb tal-PC.
Kmand ittajpjat ħażin mill-app tat-telefon	Mitigati	Lista ta' permessi fuq in-naħa tat-telefown timblokka prefissi mhux rikonoxxuti; kmandi ta' blokki ta' qabel it-titjira min-naħa tal-kumpann li jimmiraw għal servizzi ineżistenti.
kmand distruttiv run aċċidentalment	Mitigati	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Proċess PowerShell mdendla / runaway	Mitigati	Timeout iebes ta '5 minuti joqtol is-siġra tal-proċess kollu.
Companion Tbagħbis .exe bejn download u run	Mitigati	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion stat sensittiv li jnixxi l-ħabta	Mitigati	Ir-rapporti tal-ħabtiet + il-writebacks tal-iżbalji Firestore jiġu sanitizzati %USERPROFILE% / %MACHINE% / %USER%.
Apparat misruq, ppersisti ċavetta ta' pairing tar-Reġistru	Residwu	Attakkant b'aċċess disk + login jista 'jaqra l-kodiċi persistenti. Irranġat fil-ġejjieni jgħaqqadha b'Windows DPAPI.

Barra mill-ambitu

Affarijiet li WindowsHelper jagħmel b'mod espliċitu le tiddefendi kontra:

• Kont Windows kompromess tmexxija tal-kumpann. Aħna nassumu li l-PC tal-utent huwa tagħhom. Attakkant bl-admin fuq il-PC tal-utent diġà rebaħ.
• App binarja tat-telefon kompromessa. Aħna ma niffirmawx Android/iOS builds kontra t-tbagħbis lil hinn minn dak li jipprovdi l-app store tal-pjattaforma.
• Avversarji fil-livell tal-Istat bir-riżorsi biex tħassar il-PKI ta' Google's Firestore jew DigiCert's. Dan il-prodott jimmira theddid għall-konsumatur — skript kiddies, snoopers każwali, membri tad-dar disgruntled — mhux gvernijiet.
• Attakki fuq il-kanali tal-ġenb fuq AES-GCM permezz ta 'analiżi ta' enerġija / EM. Il-kumpann mhuwiex smartcard.

Żvelar

• Email support@windowshelper.app bis-suġġett [security].
• Jekk jogħġbok inkludi n-numri tal-verżjoni, il-passi ta 'repro, l-impatt, u t-tiswija ideali.
• L-ewwel tweġiba fi żmien 48 siegħa. Severità triaged fi żmien ġimgħa. Kwistjonijiet ta' severità għolja jiksbu rilaxx barra miċ-ċiklu.
• Tieqa ta' żvelar: 90 jum mir-rapport inizjali, jew aktar kmieni bi ftehim reċiproku.
• L-ebda bug bounty imħallas bħalissa - aħna r-reporters ta 'kreditu fin-noti ta' rilaxx (bil-permess).