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 den delte hemmelighed, som alle andre kryptooperationer stammer fra. Den fulde livscyklus:

[ Telefonen GENERERER en tilfældig kode på 8 tegn ]
   ↓
[ Telefonen SKRIVER koden + sessionId til Firestore i dokumentet pc_connections ]
   ↓
[ Telefonen VISER koden til brugeren på skærmen ]
   ↓
[ Brugeren LÆSER koden og skriver den i Companions indtastningsfelt ]
   ↓
[ Companion SØGER i Firestore efter en ventende session, der matcher koden ]
   ↓
[ Begge sider UDLEDER krypteringsnøgler af SHA-256(kode, sessionId) ]
   ↓
[ Koden BLIVER i hukommelsen på begge sider; ingen af dem skriver den til Firestore ]
   ↓
[ Afbrydelse / ny parring SLETTER koden på begge sider ]

• Tilfældig: koder genereret via kryptografisk sikre RNG'er.
• Alfabet på 30 tegn × 8 positioner ≈ 656 milliarder kombinationer. Udelader I, L, O, Z, 0 og 1 for at undgå visuel forveksling, ikke af sikkerhedshensyn — kodeområdet er tæt nok til, at et 10-minutters brute force-vindue med Firestores hastighedsgrænser er uigennemførligt.
• Gemmes krypteret på denne pc. Companion gemmer koden i registreringsdatabasen for din Windows-konto, krypteret med DPAPI, så den kan forbinde igen efter en genstart.
• Slettes, når du afbryder og rydder sessionen, skifter koden eller afinstallerer. Når du lukker appen, bevares den, så Companion kan forbinde igen.

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").
• Nonce: 96 bit (12 bytes), genereret frisk per besked via Random.secure() på telefon eller RandomNumberGenerator på Companion.
• Auth tag: 128 bit (16 bytes), tilføjet til chifferteksten.
• Trådformat: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Sikkerhed mod genbrug af nonce: 96-bit nonces fra en CSPRNG holder kollisionssandsynligheden efter fødselsdagsparadokset på omkring 2⁻³² over 2³² beskeder på én sessionsnøgle — standardgrænsen for tilfældige GCM-nonces, og langt ud over enhver realistisk kommandomængde.

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.
• Verifikationsrækkefølge: HMAC verificeres før dekryptering. Forfalskede meddelelser spilder ingen CPU-cyklusser på kryptografiske operationer.

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 ser AESGCM:...-blokke, ikke kommandoer.
Angriber, der kan skrive til Firestore, men ikke kender koden	Afbødet	HMAC-verificeringen mislykkes; Companion logger afvisningen og nægter at køre den.
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 er HMAC-bundet; Companion håndhæver endnu ikke et gyldighedsvindue. En fremtidig rettelse tilføjer en udløbstid.
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	Tilladelseslisten på telefonen blokerer ukendte præfikser; forhåndstjekket på Companion-siden blokerer kommandoer rettet mod tjenester, der mangler.
Destruktiv kommando køres ved et uheld	Afbødet	Et vindue på Companion-siden kræver et klik fra brugeren for at godkende Remove-Item, Format-Volume, reg delete, shutdown /r osv.
Hung / runaway PowerShell-proces	Afbødet	Hver kommando har en tidsgrænse — 5 minutter som standard, 45 for en langvarig rettelse, 60 ved det hårde loft — og hele procestræet lukkes ned.
Companion .exe manipulation mellem download og kørsel	Afbødet	SHA-256 offentliggjort i companion-version.json; brugerne kan tjekke den. Authenticode-signering er planlagt før lanceringen.
Companion nedbrudslækkende følsom tilstand	Afbødet	Nedbrudsrapporter + Firestore-fejlskrivninger renses %USERPROFILE% / %MACHINE% / %USER%.
Stjålet enhed, vedvarende registreringsdatabasenøgle	Afbødet	Den vedvarende parringskode er krypteret med Windows DPAPI (pr. konto), så den kan ikke læses fra en kopieret disk eller en anden Windows-konto.

Uden for rækkevidde

Ting, som WindowsHelper udtrykkeligt ikke beskytter 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 ressourcer til at undergrave Googles Firestore eller de certifikatudstedere, som HTTPS bygger på. Produktet er rettet mod trusler på forbrugerniveau — scriptkiddies, nysgerrige snusere, utilfredse husstandsmedlemmer — ikke regeringer.
• Sidekanalangreb på AES-GCM via strøm-/EM-analyse. Companion er ikke et smartkort.

Afsløring

• E-mail support@windowshelper.app med emne [security].
• Inkluder venligst versionsnumre, repro-trin, effekt og ideel rettelse.
• Vi sigter mod at svare inden for 48 timer og at vurdere alvoren inden for en uge. Alvorlige problemer får en udgivelse uden for den faste 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).