Sikkerhetsmodell

Hvordan WindowsHelper beskytter din PC + telefonen din, hvilken kryptografi vi bruker, og hva vi eksplisitt ikke forsvarer oss mot. Sist oppdatert: 2026-04-25.

Paringskode livssyklus

Paringskoden er delt hemmelighet annenhver kryptooperasjon stammer fra. Hele livssyklusen:

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

• Tilfeldig: koder generert via kryptografisk sikre RNG-er.
• 32-tegn alfabet × 8 posisjoner ≈ 1,1 billioner kombinasjoner. Utelukker I/O/0/1 for å unngå visuell tvetydighet, ikke sikkerhetsbetydning – koderommet er tett nok til at et 5-minutters brute-force-vindu med Firestore-hastighetsgrenser er umulig.
• Aldri skrevet til Firestore av noen av sidene. Bare WAITING session doc bærer pairingCode; når den er paret, forblir koden utelukkende i minnet.
• Tørk i minnet ved frakobling, sammenkobling på nytt eller lukking av appen.

Kryptografi

AES-256-GCM (kommandokonfidensialitet + integritet)

Hver kommando som sendes over ledningen er kryptert med AES-256-GCM, en autentisert krypteringsmodus.

• Nøkkel: 256 biter, utledet som SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Ikke: 96 bits (12 bytes), generert fersk per melding via Random.secure() på telefon eller RandomNumberGenerator på følgesvenn.
• Auth tag: 128 biter (16 byte), lagt til chifferteksten.
• Trådformat: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Sikkerhet uten gjenbruk: 96-bits nonser fra en CSPRNG gir en bursdag-paradoks kollisjonssannsynlighet på ~2⁻³² etter 2⁴⁸ meldinger – astronomisk utenfor rekkevidde for ethvert plausibelt kommandovolum.

HMAC-SHA256 (kommandoautentisitet)

Hver kommando har også en HMAC-signatur, slik at en telefon som ikke kjenner til sammenkoblingskoden ikke kan injisere kommandoer selv om den kan skrive til Firestore.

• Nøkkel: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Separer fra krypteringsnøkkelen.
• Feltomfang: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Pipene er bokstavelige rørtegn, ikke skilletegn - tre sammenkoblede strenger.
• Bekreftelsesrekkefølge: HMAC bekreftet før dekryptering. Forfalskede meldinger kaster bort null CPU-sykluser på kryptografiske primitiver.

Trusselmodell

Trussel	Status	Notater
Avlytting på det lokale nettverket	Redusert	AES-GCM chiffertekst er ugjennomsiktig for MITM-observatører.
Avlytting på Firestore-servere	Redusert	Google sees AESGCM:... blobs, not commands.
Angriper som kan skrive til Firestore, men som ikke kjenner koden	Redusert	HMAC-verifisering mislykkes; ledsager logger avvisningen + nekter utførelse.
Angriper som knekket / phishet paringskoden	Rest	De kan gi kommandoer som om de var brukeren. Redusering: roter koden fra skuffmenyen.
Avspilling av en innspilt kommando	Rest	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Uautentisert angriper i LAN-modus	Redusert	WebSocket par-håndtrykk validerer koden; HMAC + AES gate hver påfølgende kommando.
Kompromittert telefon med stjålet sammenkoblingsnøkkel	Rest	Kan ikke skilles fra "brukeren selv." Begrensning: hastighetsgrense (10 cmd/min) + destruktiv kommandobekreftelse krever klikk på PC-siden.
Feiltastet kommando fra telefonappen	Redusert	Tillatelseslisten på telefonsiden blokkerer ukjente prefikser; følgesvennside-kommandoer for blokkeringer før flygning rettet mot ikke-eksisterende tjenester.
Destruktiv kommando kjøres ved et uhell	Redusert	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Hung / runaway PowerShell-prosess	Redusert	Hard 5-minutters timeout dreper hele prosesstreet.
Companion .exe tukling mellom nedlasting og kjøring	Redusert	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion krasjlekker sensitiv tilstand	Redusert	Krasjrapporter + Firestore feilskrivninger renses %USERPROFILE% / %MACHINE% / %USER%.
Stjålet enhet, vedvarende registerparingsnøkkel	Rest	En angriper med disk + påloggingstilgang kunne lese den vedvarende koden. Fremtidig reparasjon omslutter den med Windows DPAPI.

Utenfor rekkevidde

Ting WindowsHelper eksplisitt gjør ikke forsvare mot:

• Kompromittert Windows-konto kjører følgesvennen. Vi antar at brukerens PC er deres. En angriper med admin på brukerens PC har allerede vunnet.
• Kompromittert telefonapp binær. Vi signerer ikke Android/iOS-bygg mot tukling utover det plattformens appbutikk tilbyr.
• Fiender på statsnivå med ressursene til å undergrave Googles Firestore eller DigiCerts PKI. Dette produktet retter seg mot trusler av forbrukerklasse – manusbarn, tilfeldige snokere, misfornøyde husstandsmedlemmer – ikke myndigheter.
• Sidekanalangrep på AES-GCM via strøm / EM-analyse. Ledsageren er ikke et smartkort.

Avsløring

• E-post support@windowshelper.app med emne [security].
• Vennligst inkluder versjonsnumre, repro-trinn, effekt og ideell løsning.
• Første svar innen 48 timer. Triagert alvorlighetsgrad innen en uke. Problemer med høy alvorlighetsgrad får en utgivelse utenfor syklusen.
• Avsløringsvindu: 90 dager fra første rapport, eller tidligere etter gjensidig avtale.
• Ingen utbetalt feilpremie for øyeblikket - vi krediterer reportere i utgivelsesnotater (med tillatelse).