安全模型

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 天，或更早（經雙方同意）。
• 目前沒有支付錯誤賞金——我們在發行說明中向記者表示感謝（經許可）。