Модель безопасности

Как WindowsHelper защищает ваш компьютер и телефон, какую криптографию мы используем и от чего явно не защищаемся. Последнее обновление: 25 апреля 2026 г.

Жизненный цикл кода сопряжения

Код сопряжения — это общий секрет любая другая криптографическая операция является производной. Полный жизненный цикл:

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

• Случайный: коды, генерируемые с помощью криптографически безопасных ГСЧ.
• Алфавит из 32 символов × 8 позиций ≈ 1,1 триллиона комбинаций. Исключает ввод-вывод/0/1, чтобы избежать визуальной двусмысленности, а не значения безопасности — кодовое пространство достаточно плотное, поэтому 5-минутное окно перебора с ограничениями скорости Firestore невозможно.
• Ни одна из сторон никогда не писала в Firestore. Только документ сеанса WAITING содержит 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-битные одноразовые номера из 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 см/мин) + подтверждение команды разрушения требует щелчка мыши на стороне ПК.
Неверно введена команда из приложения на телефоне	Смягченный	Белый список на стороне телефона блокирует нераспознанные префиксы; предполетная блокировка на стороне компаньона команд, нацеленных на несуществующие службы.
Деструктивная команда запускается случайно	Смягченный	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 против несанкционированного доступа за пределами того, что предоставляет магазин приложений платформы.
• Противники государственного уровня с ресурсами для подрыва Google Firestore или DigiCert PKI. Этот продукт предназначен для угроз потребительского уровня — скрипт-детей, случайных шпионов, недовольных членов семьи, а не правительств.
• Атаки по побочным каналам на AES-GCM посредством анализа мощности/ЭМ. Компаньон не является смарт-картой.

Раскрытие информации

• электронная почта support@windowshelper.app с предметом [security].
• Укажите номера версий, этапы воспроизведения, влияние и идеальное исправление.
• Первый ответ в течение 48 часов. Оценка степени тяжести в течение одной недели. Проблемы высокой важности выпускаются вне цикла.
• Период раскрытия информации: 90 дней с момента первоначального отчета или ранее по взаимному согласию.
• В настоящее время вознаграждение за обнаружение ошибок не выплачивается — мы упоминаем репортеров в примечаниях к выпуску (с разрешения).