ADB를 통해 Android TV 및 Google TV 기기에서 BadBox, XCPE, Vo1d 멀웨어를 감사하며, VPN 트래픽 센티널, IoC 차단 목록, 되돌릴 수 있는 교정 기능을 제공합니다.
공급망 트로이 목마, 봇넷, 악성코드(BadBox, XCPE, Vo1d, Fuyao, Videostrong/SZBBOYS, Residential Proxyware)에 감염된 Android TV, Google TV, 일반 스트리밍 기기를 감사, 탐지, 검증, 무력화, 복원하도록 설계된 자율적 이중 계층 포렌식, 악성코드 제거, 가역적 치료 스위트(CLI + 로컬 루프백 VPN 센티널을 갖춘 네이티브 Android TV 앱)입니다.
언어: 영어(기본) | Para a versão em Português (PT-PT), consulte README.pt.md | 📱 테스트된 기기 레지스트리 | 🔬 아키텍처 결정 (ADR) | 📜 제3자 고지
수천 대의 저가 Android TV 박스와 스마트 TV가 공장에서부터 이미 감염된 채로 출하되거나, 악성 스트리밍 앱과 트로이 목마가 심어진 펌웨어를 통해 감염됩니다. 악성코드는 일반적으로 다음과 같이 동작합니다:
package_verifier_user_consent = -1을 강제 설정하여 Google Play Protect를 조용히 비활성화합니다./system 또는 /vendor 파티션에 설치합니다(공장 초기화에도 살아남음).이 스위트는 두 가지 완전한 감사 및 정리 경로를 제공합니다:
audit_security.py)입니다.도구를 실행하거나 AI 에이전트를 파견하기 전에, Wi-Fi를 통해 감사할 수 있도록 TV에서 ADB 디버깅을 활성화하세요:
[!WARNING] 🔒 보안 모범 사례(작업 완료 후 디버깅 끄기):
가정용 Wi-Fi 네트워크에서 ADB / USB 디버깅을 영구적으로 활성화해 두면, 로컬 네트워크의 다른 기기나 악성 앱이 이론적으로 탐색할 수 있는 관리 포트(5555)가 노출됩니다.
감사와 교정이 완료되면 반드시 개발자 옵션에서 USB 디버깅을 꺼 두는 것을 잊지 마세요!
이 저장소에는 최신 AI 코딩 에이전트가 자동으로 따르는 자체 완결형 운영 지침이 AGENTS.md에 포함되어 있습니다. Python을 수동으로 구성하거나, 드라이버를 설치하거나, 명령을 작성할 필요가 없습니다.
[!IMPORTANT] 🛡️ AI 에이전트를 위한 안전한 자율 워크플로:
항상 AI 에이전트에게--quick-scan(100% 읽기 전용 진단)을 먼저 실행하도록 지시하세요.--remediate를 실행하기 전에 기술적 발견 사항과 교정 계획을 검토하세요.
AI 에이전트를 열고 다음 프롬프트 하나만 보내면 됩니다:
Clone https://github.com/Mafarricos/badbox-tv-audit.git, read AGENTS.md, and audit my Android TV at IP <TV_IP>.
(팁: TV의 IP 주소를 모른다면 에이전트에게 다음과 같이 요청하세요: ...read AGENTS.md, discover my Android TV devices on subnet 192.168.1.0/24, and audit them.)
에이전트는 자율적으로 다음을 수행합니다:
AGENTS.md를 검토합니다.community_audit_submission.json)를 생성합니다.app/)이 애플리케이션은 자동으로 현지화되며(기기가 포르투갈어로 설정된 경우 포르투갈어, 그 외 모든 언어는 영어) 100% D-Pad 탐색이 가능합니다:
/oem/, /vendor/, Play Protect 무결성, 트로이 목마 아티팩트(Vo1d, XCPE)를 감사하고 패키지 서명을 몇 초 만에 검사합니다.[CRITICAL]): TV가 알려진 C2 서버 또는 악성 도메인에 연결을 시작하는 경우.[SUSPICIOUS]): 알려진 C2 IP/도메인과 일치하지 않으면서 알려진 봇넷/프록시 포트로 연결이 이루어지는 경우.[ANOMALY]): TV가 유휴 상태일 때 비정상적인 고포트 네트워크 트래픽이 감지되는 경우.모니터링 중 네트워크 연결에 관한 참고 사항: VPN 감시 창이 활성화된 동안 DNS 쿼리(UDP 포트 53)는 적극적으로 검사되고 전달되어 악성코드 도메인 조회가 성공하도록 하는 반면, 직접적인 TCP/UDP 데이터 패킷은 검사 후 루프백 인터페이스에서 차단됩니다. 따라서 모니터가 활성화된 동안 일반 인터넷 브라우징/스트리밍은 일시적으로 중단되며 VPN이 중지되면 즉시 재개됩니다.
android.uid.system(UID 1000, 예: com.oemservice)을 공유하는 팩토리 패키지의 경우 핵심 Android 시스템 서비스를 차단하지 않도록 VPN 격리를 건너뛰며, 앱은 해당 패키지를 안전하게 동결하는 데 필요한 정확한 ADB 명령(adb shell pm disable-user --user 0 <package>)을 표시합니다. 또한 Android TV 설정이 플랫폼 서명 시스템 앱에 대해 그래픽 "비활성화" 버튼(canDisable=false)을 비활성화한다는 점도 명시합니다.바이너리 공급망 공격으로부터 저장소 무결성을 보호하기 위해 키스토어와 사전 빌드된 APK는 git에 추적되지 않습니다(SEC-01).
tools/apk_pin.json에 대해 apksigner를 사용하여 공식 서명된 APK 릴리스(xcpe-scanner-tv.apk)를 tools/로 자동 다운로드하고 검증합니다. GitHub Releases에서 수동으로 다운로드하여 tools/xcpe-scanner-tv.apk에 배치할 수도 있습니다../gradlew assembleDebug로 앱을 로컬에서 빌드하면 파이프라인이 로컬 빌드를 감지하고 명시적인 보안 경고와 함께 디버그 키를 허용합니다.cd app && ./gradlew assembleDebugcd app && ./gradlew testDebugUnitTestdocs/RELEASE_SIGNING.md