セキュリティモデル

WindowsHelper が PC と携帯電話をどのように保護するか、使用する暗号化、および明示的に防御しないもの。最終更新日: 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 を除外します。コードスペースは十分に高密度であるため、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⁻³² になります。これは、妥当なコマンド量では天文学的に不可能です。

HMAC-SHA256 (コマンドの信頼性)

すべてのコマンドには HMAC 署名も含まれるため、ペアリング コードを知らない携帯電話は、たとえ Firestore に書き込むことができたとしてもコマンドを挿入できません。

• キー: 256 bits, derived as SHA-256("WH_SECURE_{code}_{sessionId}_HMAC_KEY"). 暗号化キーとは別にしてください。
• フィールド範囲: HMAC-SHA256(hmacKey, commandId | ciphertext | sentAtMillis). パイプは区切り文字ではなく、リテラルのパイプ文字です。つまり、3 つの文字列が連結されたものです。
• 検証順序: 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 を破壊するためのリソースを使用します。この製品は、政府ではなく、消費者レベルの脅威、つまりスクリプトキディ、カジュアルな覗き見者、不満を抱いている世帯員をターゲットにしています。
• サイドチャネル攻撃 電力/EM 解析による AES-GCM 上の。コンパニオンはスマートカードではありません。

開示

• 電子メール support@windowshelper.app 件名付き [security].
• バージョン番号、再現手順、影響、理想的な修正を含めてください。
• 最初の応答は 48 時間以内に行われます。 1 週間以内に重症度をトリアージします。重大度の高い問題は、サイクル外のリリースになります。
• 開示期間: 最初の報告から 90 日、または双方の合意によりそれ以前。
• 現在、支払われたバグ報奨金はありません。リリース ノートに記者の名前が記載されています (許可を得ています)。