Sikkerhedsmodel

Hvordan WindowsHelper beskytter din pc + din telefon, hvilken kryptografi vi bruger, og hvad vi udtrykkeligt ikke forsvarer os imod. Sidst opdateret: 2026-04-25.

Parringskodes livscyklus

Parringskoden er delt hemmelighed hver anden kryptooperation stammer fra. Den fulde livscyklus:

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

• Tilfældig: koder genereret via kryptografisk sikre RNG'er.
• 32-char alfabet × 8 positioner ≈ 1,1 billioner kombinationer. Udelukker I/O/0/1 for at undgå visuel tvetydighed, ikke sikkerhedsmæssig betydning – koderummet er tæt nok til, at et 5-minutters brute-force-vindue med Firestore-hastighedsgrænser er umuligt.
• Aldrig skrevet til Firestore af nogen af ​​siderne. Kun WAITING session doc bærer pairingCode; når den er parret, forbliver koden udelukkende i hukommelsen.
• Slet i hukommelsen ved afbrydelse, genparring eller app-lukning.

Kryptografi

AES-256-GCM (kommandofortrolighed + integritet)

Hver kommando, der sendes over ledningen, er krypteret med AES-256-GCM, en autentificeret krypteringstilstand.

• Nøgle: 256 bit, afledt som SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Ikke: 96 bit (12 bytes), genereret frisk per besked via Random.secure() på telefon eller RandomNumberGenerator på ledsager.
• Auth tag: 128 bit (16 bytes), tilføjet til chifferteksten.
• Trådformat: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Sikkerhed uden genbrug: 96-bit nonces fra en CSPRNG giver en fødselsdag-paradoks kollisionssandsynlighed på ~2⁻³² efter 2⁴⁸ beskeder - astronomisk uden for rækkevidde for enhver plausibel kommandovolumen.

HMAC-SHA256 (kommandoægthed)

Hver kommando bærer også en HMAC-signatur, så en telefon, der ikke kender parringskoden, kan ikke injicere kommandoer, selvom den kan skrive til Firestore.

• Nøgle: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Adskil fra krypteringsnøglen.
• Feltområde: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Pibene er bogstavelige pibetegn, ikke afgrænsninger - tre sammenkædede strenge.
• Bekræftelsesrækkefølge: HMAC verificeret før dekryptering. Forfalskede meddelelser spilder nul CPU-cyklusser på kryptografiske primitiver.

Trusselsmodel

Trussel	Status	Noter
Aflytning på det lokale netværk	Afbødet	AES-GCM chiffertekst er uigennemsigtig for MITM-observatører.
Aflytning på Firestore-servere	Afbødet	Google sees AESGCM:... blobs, not commands.
Angriber, der kan skrive til Firestore, men ikke kender koden	Afbødet	HMAC-verifikation mislykkes; ledsager logger afvisningen + nægter eksekvering.
Angriber, der knækkede/phishede parringskoden	Rest	De kan udstede kommandoer, som om de var brugeren. Afhjælpning: Roter koden fra bakkemenuen.
Genafspilning af en optaget kommando	Rest	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
LAN-tilstand uautoriseret angriber	Afbødet	WebSocket par-håndtryk validerer koden; HMAC + AES gate hver efterfølgende kommando.
Kompromitteret telefon med stjålet parringsnøgle	Rest	Kan ikke skelnes fra "brugeren selv." Afhjælpning: hastighedsgrænse (10 cmd/min) + destruktiv kommandobekræftelse kræver klik på pc-siden.
Forkert kommando fra telefonappen	Afbødet	Tilladelsesliste på telefonen blokerer ukendte præfikser; companion-side pre-flight blokeringskommandoer rettet mod ikke-eksisterende tjenester.
Destruktiv kommando køres ved et uheld	Afbødet	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Hung / runaway PowerShell-proces	Afbødet	Hård 5-minutters timeout dræber hele procestræet.
Companion .exe manipulation mellem download og kørsel	Afbødet	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion nedbrudslækkende følsom tilstand	Afbødet	Nedbrudsrapporter + Firestore-fejlskrivninger renses %USERPROFILE% / %MACHINE% / %USER%.
Stjålet enhed, vedvarende registreringsdatabasenøgle	Rest	En angriber med disk + login-adgang kunne læse den vedvarende kode. Fremtidig rettelse omslutter det med Windows DPAPI.

Uden for rækkevidde

Ting, som WindowsHelper eksplicit gør ikke forsvare mod:

• Kompromitteret Windows konto kører ledsageren. Vi antager, at brugerens pc er deres. En angriber med admin på brugerens pc har allerede vundet.
• Kompromitteret telefonapp binær. Vi underskriver ikke Android/iOS builds mod manipulation ud over, hvad platformens app-butik tilbyder.
• Modstandere på statsniveau med ressourcerne til at undergrave Googles Firestore eller DigiCerts PKI. Dette produkt er rettet mod trusler af forbrugerkvalitet – manuskriptbørn, tilfældige snoopere, utilfredse husstandsmedlemmer – ikke regeringer.
• Sidekanalangreb på AES-GCM via strøm / EM-analyse. Ledsageren er ikke et smartcard.

Afsløring

• E-mail support@windowshelper.app med emne [security].
• Inkluder venligst versionsnumre, repro-trin, effekt og ideel rettelse.
• Første svar inden for 48 timer. Triageret sværhedsgrad inden for en uge. Problemer med høj alvorlighed får en udgivelse uden for cyklus.
• Oplysningsperiode: 90 dage fra den første rapport eller tidligere efter gensidig aftale.
• Ingen betalt bug-bounty i øjeblikket - vi krediterer reportere i release notes (med tilladelse).