Beveiligingsmodel

Hoe WindowsHelper uw pc en uw telefoon beschermt, welke cryptografie we gebruiken en waar we ons expliciet niet tegen verdedigen. Laatst bijgewerkt: 25-04-2026.

Levenscyclus van koppelingscode

De koppelingscode is de gedeeld geheim elke andere crypto-operatie komt voort uit. De volledige levenscyclus:

[ 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: codes gegenereerd via cryptografisch beveiligde RNG's.
• Alfabet van 32 tekens × 8 posities ≈ 1,1 biljoen combinaties. Sluit I/O/0/1 uit om visuele dubbelzinnigheid te voorkomen, en niet om veiligheidsbelangen. De coderuimte is zo compact dat een brute-force-venster van 5 minuten met Firestore-snelheidslimieten onhaalbaar is.
• Nooit door een van beide partijen naar Firestore geschreven. Alleen het WAITING-sessiedocument is geldig pairingCode; eenmaal gekoppeld blijft de code uitsluitend in het geheugen.
• In het geheugen wissen bij het verbreken van de verbinding, opnieuw koppelen of het sluiten van de app.

Cryptografie

AES-256-GCM (opdracht vertrouwelijkheid + integriteit)

Elke opdracht die via de draad wordt verzonden, wordt gecodeerd met AES-256-GCM, een geverifieerde coderingsmodus.

• Sleutel: 256 bits, afgeleid als SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce: 96 bits (12 bytes), vers gegenereerd per bericht via Random.secure() op telefoon of RandomNumberGenerator op metgezel.
• Authenticatietag: 128 bits (16 bytes), toegevoegd aan de cijfertekst.
• Draadformaat: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Veiligheid bij niet-hergebruik: 96-bits nonces van een CSPRNG geven een botsingskans op verjaardagsparadox van ~2⁻³² na 2⁴⁸ berichten – astronomisch buiten bereik voor elk plausibel commandovolume.

HMAC-SHA256 (authenticiteit van opdrachten)

Elke opdracht heeft ook een HMAC-handtekening, zodat een telefoon die de koppelingscode niet kent, geen opdrachten kan injecteren, zelfs als deze naar Firestore kan schrijven.

• Sleutel: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Los van de coderingssleutel.
• Veldbereik: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). De pijpen zijn letterlijke pijptekens, geen scheidingstekens: drie aaneengeschakelde strings.
• Verificatievolgorde: HMAC geverifieerd voor decodering. Vervalste berichten verspillen nul CPU-cycli aan cryptografische primitieven.

Bedreigingsmodel

Bedreiging	Status	Opmerkingen
Afluisteraar op het lokale netwerk	Verzacht	AES-GCM-cijfertekst is ondoorzichtig voor MITM-waarnemers.
Afluisteraar op Firestore-servers	Verzacht	Google sees AESGCM:... blobs, not commands.
Aanvaller die naar Firestore kan schrijven maar de code niet kent	Verzacht	HMAC-verificatie mislukt; metgezel registreert de afwijzing + weigert uitvoering.
Aanvaller die de koppelingscode heeft gekraakt/phished	Resterend	Zij kunnen opdrachten geven alsof zij de gebruiker zijn. Oplossing: roteer de code vanuit het lademenu.
Herhaling van een opgenomen commando	Resterend	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Niet-geverifieerde aanvaller in LAN-modus	Verzacht	WebSocket-paarhandshake valideert de code; HMAC + AES-poort elke volgende opdracht.
Gecompromitteerde telefoon met gestolen koppelingssleutel	Resterend	Niet te onderscheiden van ‘de gebruiker zelf’. Beperking: snelheidslimiet (10 cmd/min) + bevestiging van destructieve opdracht vereist klikken op de pc.
Verkeerd getypte opdracht uit de telefoonapp	Verzacht	De toelatingslijst aan de telefoonzijde blokkeert niet-herkende voorvoegsels; begeleidende pre-flight blokkeert opdrachten die gericht zijn op niet-bestaande services.
Destructieve opdracht wordt per ongeluk uitgevoerd	Verzacht	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Vastgelopen/op hol geslagen PowerShell-proces	Verzacht	Een harde time-out van 5 minuten doodt de hele procesboom.
Companion Er wordt geknoeid met .exe tussen downloaden en uitvoeren	Verzacht	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion crash lekt gevoelige status	Verzacht	Crashrapporten + terugschrijven van Firestore-fouten wordt opgeschoond %USERPROFILE% / %MACHINE% / %USER%.
Gestolen apparaat, registratiesleutel blijft bestaan	Resterend	Een aanvaller met schijf- en inlogtoegang zou de persistente code kunnen lezen. Bij een toekomstige oplossing wordt dit omhuld met Windows DPAPI.

Buiten bereik

Dingen die WindowsHelper expliciet doet niet verdedigen tegen:

• Gehackt Windows-account de metgezel runnen. We gaan ervan uit dat de pc van de gebruiker van hem is. Een aanvaller met beheerder op de pc van de gebruiker heeft al gewonnen.
• Gecompromitteerde binaire telefoonapp. We ondertekenen geen Android/iOS-builds tegen manipulatie die verder gaan dan wat de app store van het platform biedt.
• Tegenstanders op staatsniveau met de middelen om de Firestore van Google of de PKI van DigiCert te ondermijnen. Dit product richt zich op bedreigingen van consumentenkwaliteit – scriptkiddies, toevallige snoopers, ontevreden leden van het huishouden – en niet op regeringen.
• Zijkanaalaanvallen op AES-GCM via stroom-/EM-analyse. De begeleider is geen smartcard.

Openbaarmaking

• E-mail support@windowshelper.app met onderwerp [security].
• Vermeld versienummers, reprostappen, impact en ideale oplossing.
• Eerste reactie binnen 48 uur. Triage van ernst binnen één week. Problemen met een hoge ernst krijgen een release die buiten de cyclus valt.
• Openbaarmakingstermijn: 90 dagen vanaf het eerste rapport, of eerder in onderling overleg.
• Er is momenteel geen betaalde bugbounty. We vermelden de verslaggevers in de release-opmerkingen (met toestemming).