セキュリティモデル

WindowsHelper が PC と携帯電話をどのように保護するか、使用する暗号化、および明示的に防御しないもの。最終更新日: 2026-04-25。

ペアリングコードのライフサイクル

ペアリングコードは、他のすべての暗号操作の派生元となる共有秘密です。ライフサイクル全体:

[ スマホが 8 文字のランダムなコードを生成 ]
   ↓
[ スマホがコードと sessionId を Firestore の pc_connections ドキュメントに書き込み ]
   ↓
[ スマホが画面にコードを表示 ]
   ↓
[ ユーザーがコードを読み、Companion の入力欄に入力 ]
   ↓
[ Companion がコードに一致する待機中セッションを Firestore に照会 ]
   ↓
[ 両側が SHA-256(コード, sessionId) から暗号鍵を導出 ]
   ↓
[ コードは両側のメモリ内にとどまり、どちらも Firestore には書き込まない ]
   ↓
[ 切断・再ペアリングで両側からコードを消去 ]

• ランダム: 暗号的に安全な RNG 経由で生成されたコード。
• 30 文字のアルファベット × 8 桁 ≈ 6560 億通り。 見間違いを避けるため I、L、O、Z、0、1 を除いています。セキュリティ上の理由ではありません。コード空間は十分に密で、Firestore のレート制限のもとでは 10 分間の総当たり攻撃は成立しません。
• この PC に暗号化して保存されます。 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 再利用の安全性: CSPRNG から生成した 96 ビットの nonce は、1 つのセッションキーで 2³² メッセージにわたり、誕生日のパラドックスによる衝突確率をおよそ 2⁻³² に保ちます。これはランダムな GCM nonce の標準的な上限であり、現実に想定されるコマンド量をはるかに超えています。

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 に見えるのは AESGCM:... のかたまりであって、コマンドではありません。
Firestore に書き込むことはできるがコードを知らない攻撃者	緩和された	HMAC 検証が失敗します。Companion は拒否を記録し、実行しません。
ペアリングコードをクラッキング/フィッシングした攻撃者	残留物	ユーザーは、あたかもユーザーであるかのようにコマンドを発行できます。軽減策: トレイ メニューからコードをローテーションします。
記録されたコマンドの再生	残留物	sentAtMillis は HMAC に結び付けられています。Companion はまだ有効期間を強制していません。今後の修正で有効期限を追加します。
LANモードの非認証攻撃者	緩和された	WebSocket ペアのハンドシェイクによりコードが検証されます。 HMAC + AES は後続のコマンドごとにゲートします。
ペアリングキーが盗まれた携帯電話が侵害される	残留物	「ユーザー自身」と区別がつかない。軽減策: レート制限 (10 cmd/min) + 破壊的コマンドの確認には PC 側のクリックが必要です。
電話アプリからのコマンドの入力ミス	緩和された	スマホ側の許可リストが未知のプレフィックスを遮断し、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 アカウントが侵害されました コンパニオンを実行します。ユーザーの PC は自分のものであると想定します。ユーザーの PC を管理者とする攻撃者がすでに勝利しています。
• 電話アプリのバイナリが侵害されました。 私たちは、プラットフォームのアプリ ストアが提供するものを超えた改ざんに対して Android/iOS ビルドに署名しません。
• 国家レベルの攻撃者: Google の Firestore や、HTTPS を支える認証局を突破できるだけの資源を持つ相手。この製品が想定しているのは一般利用者レベルの脅威 (スクリプトキディ、興味本位ののぞき見、不満を抱えた同居人) で、政府は対象外です。
• 電力・電磁解析による AES-GCM へのサイドチャネル攻撃。Companion はスマートカードではありません。

開示

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