보안 모델

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비트 nonce는 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 인증됨 전에 해독. 위조된 메시지는 암호화 기본 요소에서 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는 모든 후속 명령을 게이트합니다.
도난당한 페어링 키로 손상된 휴대폰	잔여	"사용자 자신"과 구별할 수 없습니다. 완화: 속도 제한(10cmd/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시간 이내에 첫 번째 응답. 일주일 이내에 심각도를 분류합니다. 심각도가 높은 문제는 주기 외 릴리스를 받습니다.
• 공개 기간: 최초 보고로부터 90일 또는 상호 합의에 따라 그 이전.
• 현재는 유료 버그 현상금이 없습니다. 릴리스 노트에 보고자의 이름을 기재합니다(허가를 받아).