安全模型

WindowsHelper 如何保护您的 PC + 手机、我们使用哪些加密技术以及我们明确不防御哪些内容。最后更新时间：2026 年 4 月 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 是为了避免视觉上的歧义，而不是安全意义 - 代码空间足够密集，以至于具有 Firestore 速率限制的 5 分钟暴力窗口是不可行的。
• 任何一方都从未向 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>
• 一次性重用安全性： 来自 CSPRNG 的 96 位随机数在 2⁴⁸ 消息后给出的生日悖论碰撞概率约为 2⁻32 — 对于任何看似合理的命令量而言，这在天文数字上是无法达到的。

HMAC-SHA256（命令真实性）

每个命令还带有 HMAC 签名，因此不知道配对代码的手机即使可以写入 Firestore，也无法注入命令。

• 关键： 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). 与加密密钥分开。
• 领域范围： HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). 管道是文字管道字符，而不是分隔符 - 三个连接的字符串。
• 验证顺序： HMAC 已验证 之前 解密。伪造的消息在加密原语上浪费了零个 CPU 周期。

威胁模型

威胁	状态	注释
本地网络的窃听者	缓解	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.
LAN 模式未经身份验证的攻击者	缓解	WebSocket配对握手验证代码； HMAC + AES 门控每个后续命令。
配对密钥被盗的手机被盗	残差	与“用户本身”没有区别。缓解措施：速率限制（10 cmd/min）+破坏性命令确认需要 PC 端点击。
从手机应用程序输入错误的命令	缓解	电话端允许列表阻止无法识别的前缀；同伴端飞行前会阻止针对不存在服务的命令。
意外运行破坏性命令	缓解	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 帐户 运行同伴。我们假设用户的PC是他们的。在用户的 PC 上拥有管理员权限的攻击者已经获胜。
• 受损的手机应用程序二进制文件。 我们不会对 Android/iOS 构建进行签名，以防止超出平台应用程序商店提供的篡改功能。
• 国家级对手 拥有颠覆 Google 的 Firestore 或 DigiCert 的 PKI 的资源。该产品针对消费者级威胁——脚本小子、随意窥探者、心怀不满的家庭成员——而不是政府。
• 旁路攻击 通过功率/电磁分析在 AES-GCM 上进行。该伴侣不是智能卡。

披露

• 电子邮件 support@windowshelper.app 有主题 [security].
• 请包含版本号、重现步骤、影响和理想修复。
• 48 小时内第一时间回复。在一周内对严重程度进行分类。高严重性问题会进行周期外发布。
• 披露期限：自初次报告起 90 天，或更早（经双方同意）。
• 目前没有支付错误赏金——我们在发行说明中向记者表示感谢（经许可）。