← Назад до WindowsHelper

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

Як WindowsHelper захищає ваш комп’ютер і ваш телефон, яку криптографію ми використовуємо, а від чого ми явно не захищаємося. Останнє оновлення: 2026-04-25.

повідомлення про вразливість

Електронна пошта support@windowshelper.app з предметом [security]. Будь ласка, не відкривайте загальнодоступні проблеми GitHub — дайте нам вікно, щоб надіслати виправлення перед розголошенням.

Життєвий цикл сполучення коду

Код сполучення — це спільний секрет, з якого походить кожна інша криптооперація. Повний життєвий цикл:

[ Телефон СТВОРЮЄ випадковий код із 8 символів ]
   ↓
[ Телефон ЗАПИСУЄ код + sessionId у Firestore, у документ pc_connections ]
   ↓
[ Телефон ПОКАЗУЄ код користувачеві на екрані ]
   ↓
[ Користувач ЧИТАЄ код і вводить його в поле Companion ]
   ↓
[ Companion ШУКАЄ у Firestore сеанс в очікуванні, що відповідає коду ]
   ↓
[ Обидві сторони ВИВОДЯТЬ ключі шифрування з SHA-256(код, sessionId) ]
   ↓
[ Код ЗАЛИШАЄТЬСЯ в пам'яті з обох боків; жодна не записує його у Firestore ]
   ↓
[ Відключення / повторне спарювання СТИРАЄ код з обох боків ]

випадковий: коди, згенеровані через криптографічно захищені RNG.
Алфавіт із 30 символів × 8 позицій ≈ 656 мільярдів комбінацій. Виключено I, L, O, Z, 0 і 1, щоб їх не плутали на вигляд, а не з міркувань безпеки — простір кодів достатньо щільний, щоб десятихвилинне вікно перебору за обмежень частоти Firestore було нездійсненним.
Зберігається зашифрованим на цьому ПК. Companion зберігає код у реєстрі вашого облікового запису Windows, зашифрованим через DPAPI, щоб після перезапуску підключитися знову.
Стирається, коли ви від'єднуєтеся й очищуєте сеанс, змінюєте код або видаляєте програму. Під час закриття застосунку він зберігається, щоб Companion міг підключитися знову.

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

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

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

ключ: 256 біт, отримано як SHA-256("WH_SECURE_{code}_{sessionId}_CMD_KEY").
Nonce: 96 біт (12 байт), щойно створені для кожного повідомлення через Random.secure() по телефону або RandomNumberGenerator на боці Companion.
Тег авторизації: 128 біт (16 байт), доданих до зашифрованого тексту.
Формат дроту: AESGCM:<nonce_b64>:<ciphertext_b64>:<tag_b64>
Безпека від повторного використання nonce: 96-бітні nonce від CSPRNG утримують імовірність колізії за парадоксом днів народження на рівні близько 2⁻³² протягом 2³² повідомлень з одним сеансовим ключем — це стандартна межа для випадкових nonce у GCM і значно більше за будь-який правдоподібний обсяг команд.

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 бачить блоки `AESGCM:...`, а не команди.
Зловмисник, який може писати у Firestore, але не знає коду	Пом'якшено	Перевірка HMAC не проходить; Companion записує відмову й не виконує команду.
Зловмисник, який зламав/зібрав код підключення	Залишковий	Вони можуть видавати команди, як якщо б вони були користувачем. Пом'якшення: поверніть код із меню трея.
Повторне відтворення записаної команди	Залишковий	`sentAtMillis` прив'язаний до HMAC; Companion поки не перевіряє вікно актуальності. Майбутнє виправлення додасть термін дії.
Неавтентифікований зловмисник у режимі локальної мережі	Пом'якшено	Рукостискання пари WebSocket перевіряє код; HMAC + AES gate кожна наступна команда.
Зламаний телефон із вкраденим ключем сполучення	Залишковий	Невідрізнити від «самого користувача». Пом'якшення: обмеження швидкості (10 cmd/хв) + підтвердження руйнівної команди вимагає клацання на стороні ПК.
Неправильно введена команда з програми для телефону	Пом'якшено	Список дозволів на боці телефона блокує невідомі префікси; попередня перевірка на боці Companion блокує команди до неіснуючих служб.
Деструктивна команда запускається випадково	Пом'якшено	Вікно на боці Companion вимагає натискання користувача, щоб підтвердити `Remove-Item`, `Format-Volume`, `reg delete`, `shutdown /r` тощо.
Завислий/неактивний процес PowerShell	Пом'якшено	Кожна команда має обмеження в часі — 5 хвилин за замовчуванням, 45 для тривалого виправлення, 60 на жорсткій стелі — і завершується все дерево процесів.
Companion .exe змінюється між завантаженням і запуском	Пом'якшено	SHA-256 публікується в `companion-version.json`; користувачі можуть його перевірити. Підпис Authenticode заплановано до запуску.
Companion аварійно завершується витік конфіденційного стану	Пом'якшено	Звіти про збої + очищення зворотних записів про помилки Firestore `%USERPROFILE%` / `%MACHINE%` / `%USER%`.
Викрадений пристрій, збережений ключ сполучення реєстру	Пом'якшено	Постійний код сполучення зашифровано за допомогою Windows DPAPI (для кожного облікового запису), тому його не можна прочитати зі скопійованого диска чи іншого облікового запису Windows.

Поза рамками

Те, від чого WindowsHelper явно не захищає:

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

Розкриття

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