Мадэль бяспекі

Як WindowsHelper абараняе ваш ПК і тэлефон, якую крыптаграфію мы выкарыстоўваем і ад чаго яўна не абараняемся. Апошняе абнаўленне: 2026-04-25.

Жыццёвы цыкл спалучэння кода

Код спалучэння - гэта агульны сакрэт усе іншыя крыпта-аперацыі паходзяць з. Поўны жыццёвы цыкл:

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

• Выпадковы: codes generated via cryptographically secure RNGs.
• 32-char alphabet × 8 positions ≈ 1.1 trillion combinations. Выключае I/O/0/1, каб пазбегнуць візуальнай неадназначнасці, а не важнасці для бяспекі - кодавая прастора досыць шчыльная, каб 5-хвіліннае акно грубай сілы з абмежаваннямі хуткасці Firestore было невыканальным.
• Ніколі не пісаў у Firestore ні з аднаго боку. Толькі дакумент сесіі ЧАКАННЯ нясе pairingCode; пасля спалучэння код застаецца выключна ў памяці.
• Ачыстка ў памяці пры адключэнні, паўторным спалучэнні або закрыцці праграмы.

Крыптаграфія

AES-256-GCM (канфідэнцыяльнасць каманды + цэласнасць)

Кожная каманда, адпраўленая па дроце, шыфруецца з дапамогай AES-256-GCM, рэжыму шыфравання з аўтэнтыфікацыяй.

• Ключ: 256 біт, атрыманы як SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Адзін раз: 96 біт (12 байт), толькі што згенераваных для кожнага паведамлення праз Random.secure() па тэлефоне або RandomNumberGenerator на спадарожніка.
• Тэг аўтарызацыі: 128 біт (16 байт), далучаных да зашыфраванага тэксту.
• Фармат правадоў: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
• Бяспека без паўторнага выкарыстання: 96-бітныя nonces з CSPRNG даюць верагоднасць сутыкнення дня нараджэння з парадоксам ~2⁻³² пасля 2⁴⁸ паведамленняў - астранамічна недаступна для любога праўдападобнага аб'ёму каманд.

HMAC-SHA256 (аўтэнтычнасць каманды)

Кожная каманда таксама мае подпіс HMAC, таму тэлефон, які не ведае кода спалучэння, не можа ўводзіць каманды, нават калі ён можа пісаць у Firestore.

• Ключ: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). Асобна ад ключа шыфравання.
• Ахоп поля: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). Трубы - гэта літаральныя сімвалы трубы, а не падзельнікі - тры канкатэнаваныя радкі.
• Парадак праверкі: Праверана HMAC раней дэшыфроўка. Падробленыя паведамленні не марнуюць нуль цыклаў працэсара на крыптаграфічныя прымітывы.

Мадэль пагрозы

Пагроза	Статус	Заўвагі
Праслухоўка ў лакальнай сеткі	Змякчаны	Шыфраваны тэкст AES-GCM непразрысты для назіральнікаў MITM.
Праслухоўванне на серверах Firestore	Змякчаны	Google sees AESGCM:... blobs, not commands.
Зламыснік, які можа пісаць у Firestore, але не ведае кода	Змякчаны	Збой праверкі HMAC; кампаньён рэгіструе адмову + адмаўляецца ад выканання.
Зламыснік, які ўзламаў / падмануў код спалучэння	Рэшткавы	Яны могуць аддаваць каманды, як калі б яны былі карыстальнікам. Змякчэнне: павярніце код з меню трэя.
Паўтор запісанай каманды	Рэшткавы	sentAtMillis is HMAC-bound; companion doesn't yet enforce a freshness window. Future fix adds a TTL.
Неаўтэнтыфікаваны зламыснік у рэжыме лакальнай сеткі	Змякчаны	Рукапоціск пары WebSocket правярае код; Шлюз HMAC + AES кожная наступная каманда.
Узламаны тэлефон са скрадзеным ключом спалучэння	Рэшткавы	Неадрозны ад «самога карыстальніка». Змякчэнне: абмежаванне хуткасці (10 cmd/мін) + пацвярджэнне дэструктыўнай каманды патрабуе пстрычкі з боку ПК.
Памылковая каманда з праграмы для тэлефона	Змякчаны	Белы спіс на баку тэлефона блакуе нераспазнаныя прэфіксы; кампаньён перад палётам блакуе каманды, накіраваныя на неіснуючыя службы.
Разбуральная каманда запускаецца выпадкова	Змякчаны	Companion-side modal requires user click to approve Remove-Item, Format-Volume, reg delete, shutdown /r, etc.
Завіс / непрацуючы працэс PowerShell	Змякчаны	Жорсткі 5-хвілінны тайм-аўт забівае ўсё дрэва працэсаў.
Companion .exe маніпуляцыя паміж загрузкай і запускам	Змякчаны	SHA-256 published in companion-version.json; users can verify. Authenticode signing landing soon.
Companion збой з уцечкай адчувальнага стану	Змякчаны	Справаздачы аб збоях + зваротныя запісы памылак Firestore дэзінфікуюць %USERPROFILE% / %MACHINE% / %USER%.
Выкрадзеная прылада, захоўваецца ключ спалучэння рэестра	Рэшткавы	Зламыснік з доступам да дыска + уваход можа прачытаць захаваны код. Будучае выпраўленне ахінае яго Windows DPAPI.

Па-за рамкамі

Тое, што WindowsHelper робіць відавочна не абараняцца ад:

• Скампраметаваны ўліковы запіс Windows працуе спадарожнік. Мы мяркуем, што ПК карыстальніка належыць ім. Зламыснік з адміністратарам на ПК карыстальніка ўжо перамог.
• Скампраметаваны двайковы файл праграмы для тэлефона. Мы не падпісваем зборкі Android/iOS супраць маніпуляцый, акрамя таго, што прапануе крама прыкладанняў платформы.
• Праціўнікі дзяржаўнага ўзроўню з рэсурсамі для падрыву Firestore Google або PKI DigiCert. Гэты прадукт нацэлены на пагрозы спажывецкага класа - на сцэнарыстаў, выпадковых шпіёнаў, незадаволеных членаў сям'і - а не на ўрады.
• Атакі бакавога канала на AES-GCM праз аналіз электраэнергіі / ЭМ. Кампаньён не з'яўляецца смарт-картай.

Раскрыццё інфармацыі

• Электронная пошта support@windowshelper.app з прадметам [security].
• Калі ласка, уключыце нумары версій, этапы ўзнаўлення, уплыў і ідэальнае выпраўленне.
• Першы адказ на працягу 48 гадзін. Сартаванне па ступені цяжкасці на працягу аднаго тыдня. Праблемы высокай ступені сур'ёзнасці выпускаюцца па-за цыклам.
• Перыяд раскрыцця інфармацыі: 90 дзён з моманту першапачатковай справаздачы або раней па ўзаемнай згодзе.
• У цяперашні час выплаты за памылку не выплачваецца — мы адзначаем рэпарцёраў у нататках да выпуску (з дазволу).