Säkerhetsmodell

Hur WindowsHelper skyddar din dator + din telefon, vilken kryptografi vi använder och vad vi uttryckligen inte försvarar oss mot. Senast uppdaterad: 2026-04-25.

Parningskods livscykel

Parningskoden är delad hemlighet varannan kryptooperation härrör från. Hela livscykeln:

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

• Slumpmässigt: koder genererade via kryptografiskt säkra RNG:er.
• Alfabetet med 32 tecken × 8 positioner ≈ 1,1 biljoner kombinationer. Utesluter I/O/0/1 för att undvika visuell tvetydighet, inte säkerhetsbetydelse – kodutrymmet är tillräckligt tätt för att ett 5-minuters brute-force-fönster med Firestore-hastighetsgränser är omöjligt.
• Har aldrig skrivit till Firestore av någon sida. Endast WAITING session doc bär pairingCode; När den väl har parats förblir koden uteslutande i minnet.
• Torka i minnet vid frånkoppling, parkoppling eller app stängning.

Kryptografi

AES-256-GCM (kommandokonfidentialitet + integritet)

Varje kommando som skickas över tråden krypteras med AES-256-GCM, ett autentiserat krypteringsläge.

• Nyckel: 256 bitar, härledd som SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce: 96 bitar (12 byte), genererade färskt per meddelande via Random.secure() på telefon eller RandomNumberGenerator på sällskap.
• Auth-tagg: 128 bitar (16 byte), läggs till chiffertexten.
• Trådformat: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Säkerhet för icke-återanvändning: 96-bitars nonces från en CSPRNG ger en födelsedagsparadoxkollisionsannolikhet på ~2⁻³² efter 2⁴⁸ meddelanden - astronomiskt utom räckhåll för någon rimlig kommandovolym.

HMAC-SHA256 (kommandoäkthet)

Varje kommando har också en HMAC-signatur så en telefon som inte känner till parningskoden kan inte injicera kommandon även om den kan skriva till Firestore.

• Nyckel: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Separera från krypteringsnyckeln.
• Fältomfång: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Pipen är bokstavliga piptecken, inte avgränsare - tre sammanlänkade strängar.
• Verifieringsordning: HMAC verifierad innan dekryptering. Förfalskade meddelanden slösar noll CPU-cykler på kryptografiska primitiver.

Hotmodell

Hot	Status	Anteckningar
Avlyssnare på det lokala nätverket	Milderad	AES-GCM chiffertext är ogenomskinlig för MITM-observatörer.
Avlyssning på Firestore-servrar	Milderad	Google sees AESGCM:... blobs, not commands.
Angripare som kan skriva till Firestore men inte känner till koden	Milderad	HMAC-verifiering misslyckas; companion loggar avslaget + vägrar körning.
Angripare som knäckte / nätfiskade parningskoden	Rest	De kan utfärda kommandon som om de vore användaren. Begränsning: rotera koden från fältmenyn.
Uppspelning av ett inspelat kommando	Rest	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Oautentiserad angripare i LAN-läge	Milderad	WebSocket-handskakning validerar koden; HMAC + AES gate varje efterföljande kommando.
Komprometterad telefon med stulen kopplingsnyckel	Rest	Kan inte skiljas från "användaren själva". Begränsning: hastighetsgräns (10 cmd/min) + destruktiv kommandobekräftelse kräver klick på PC-sidan.
Felskrivet kommando från telefonappen	Milderad	Tillståndslista på telefonsidan blockerar okända prefix; följeslagare-sida pre-flight block kommandon inriktade på obefintliga tjänster.
Destruktivt kommando körs av misstag	Milderad	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Hängd/runaway PowerShell-process	Milderad	Hård 5-minuters timeout dödar hela processträdet.
Companion .exe-manipulering mellan nedladdning och körning	Milderad	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion kraschläckande känsligt tillstånd	Milderad	Kraschrapporter + Firestore-felåterskrivningar saneras %USERPROFILE% / %MACHINE% / %USER%.
Stulen enhet, beständig registerparningsnyckel	Rest	En angripare med åtkomst till disk + inloggning kunde läsa den kvarstående koden. Framtida korrigering omsluter det med Windows DPAPI.

Utanför räckvidd

Saker som WindowsHelper uttryckligen gör inte försvara sig mot:

• Intrång i Windows konto kör följeslagaren. Vi antar att användarens dator är deras. En angripare med administratör på användarens dator har redan vunnit.
• Kompromissad telefonapp binär. Vi signerar inte Android/iOS builds mot manipulering utöver vad plattformens appbutik tillhandahåller.
• motståndare på statsnivå med resurserna för att undergräva Googles Firestore eller DigiCerts PKI. Den här produkten riktar sig mot hot av konsumentklass – manusbarn, tillfälliga snokare, missnöjda hushållsmedlemmar – inte regeringar.
• Sidokanalattacker på AES-GCM via effekt / EM-analys. Följeslagaren är inte ett smartkort.

Avslöjande

• E-post support@windowshelper.app med ämne [security].
• Inkludera versionsnummer, reprosteg, effekt och idealisk fix.
• Första svar inom 48 timmar. Triagerad svårighetsgrad inom en vecka. Problem med hög allvar får en release utanför cykeln.
• Upplysningsperiod: 90 dagar från den första rapporten, eller tidigare enligt ömsesidig överenskommelse.
• Ingen betald buggpremie för närvarande - vi krediterar reportrar i release notes (med tillåtelse).