Модель безпеки

Як 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 ]

• випадковий: коди, згенеровані через криптографічно захищені RNG.
• 32-символьний алфавіт × 8 позицій ≈ 1,1 трильйона комбінацій. Виключає I/O/0/1, щоб уникнути візуальної неоднозначності, а не важливості для безпеки — кодовий простір достатньо щільний, щоб 5-хвилинне вікно грубої сили з обмеженнями швидкості Firestore було неможливим.
• Жодна сторона ніколи не писала у Firestore. Переносить лише документ сесії ОЧІКУВАННЯ pairingCode; після створення пари код залишається виключно в пам’яті.
• Стирання в пам’яті під час відключення, повторного підключення або закриття програми.

Криптографія

AES-256-GCM (конфіденційність команд + цілісність)

Кожна команда, що надсилається по дроту, шифрується за допомогою AES-256-GCM, режиму автентифікованого шифрування.

• ключ: 256 біт, отримано як SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
• Nonce: 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 gate кожна наступна команда.
Зламаний телефон із вкраденим ключем сполучення	Залишковий	Невідрізнити від «самого користувача». Пом'якшення: обмеження швидкості (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 (для кожного облікового запису), тому його не можна прочитати зі скопійованого диска чи іншого облікового запису Windows.

Поза рамками

Те, що WindowsHelper робить явно ні захистити від:

• Зламаний обліковий запис Windows біжить компаньйон. Ми припускаємо, що ПК користувача належить йому. Зловмисник з адміністратором на ПК користувача вже виграв.
• Зламана двійкова програма для телефону. Ми не захищаємо збірки Android/iOS від несанкціонованого втручання, окрім того, що пропонує магазин додатків платформи.
• Противники державного рівня з ресурсами, щоб підірвати Firestore Google або PKI DigiCert. Цей продукт націлений на загрози споживчого рівня — сценарних дітей, випадкових шпигунів, незадоволених членів родини — а не на уряди.
• Атаки по бічному каналу на AES-GCM за допомогою аналізу потужності/ЕМ. Companion не є смарт-карткою.

Розкриття

• Електронна пошта support@windowshelper.app з предметом [security].
• Укажіть номери версій, кроки відтворення, вплив і ідеальне виправлення.
• Перша відповідь протягом 48 годин. Сортування тяжкості протягом одного тижня. Проблеми високого ступеня серйозності отримують випуск поза циклом.
• Період розкриття інформації: 90 днів з моменту первинного звіту або раніше за взаємною згодою.
• Наразі немає винагороди за помилки — ми згадуємо репортерів у примітках до випуску (з дозволу).