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) | 📜 サードパーティ通知
何千台もの低価格 Android TV ボックスやスマート TV が、工場出荷時点で感染した状態で届くか、悪意のあるストリーミングアプリやトロイの木馬化されたファームウェアによって侵害されます。マルウェアは通常、次のことを行います:
package_verifier_user_consent = -1 を強制することで、Google Play Protect をサイレントに無効化します。/system または /vendor パーティションにインストールします (工場出荷時リセットを生き延びます)。このスイートは、2 つの完全な監査・クリーンアップ経路を提供します:
audit_security.py)。ツールを実行したり AI エージェントを派遣したりする前に、Wi-Fi 経由で監査できるよう TV で ADB デバッグ を有効化します:
[!WARNING] 🔒 セキュリティのベストプラクティス(作業完了後はデバッグをオフに):
自宅の Wi-Fi ネットワーク上で ADB / USB デバッグを常時有効にしたままにすると、管理ポート(5555)が公開され、ローカルネットワーク上の他のデバイスや悪意のあるアプリが理論上プローブできる状態になります。
監査と修復が完了したら、必ず開発者向けオプションで USB デバッグをオフにすることを忘れないでください!
このリポジトリには、最新の AI コーディングエージェントが自動的に従う自己完結型の運用ガイドラインが AGENTS.md に含まれています。Python を手動で設定したり、ドライバーをインストールしたり、コマンドを書いたりする必要はありません。
[!IMPORTANT] 🛡️ AI エージェント向けの安全な自律ワークフロー:
まず最初に--quick-scan(100% 読み取り専用の診断)を実行するよう、AI エージェントに必ず指示してください。--remediateを実行する前に、技術的な検出結果と修復計画を確認してください。
AI エージェントを開き、次のプロンプトを 1 つ送信するだけです:
Clone https://github.com/Mafarricos/badbox-tv-audit.git, read AGENTS.md, and audit my Android TV at IP <TV_IP>.
(ヒント: テレビの 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]): テレビが既知の C2 サーバーまたは悪意のあるドメインへの接続を開始した場合。[SUSPICIOUS]): 既知の C2 IP/ドメインに一致しない、既知のボットネット/プロキシポートへの接続が行われた場合。[ANOMALY]): テレビがアイドル状態のときに異常な高ポートのネットワークトラフィックが検出された場合。監視中のネットワーク接続に関する注意: 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)。
xcpe-scanner-tv.apk)を自動的にダウンロードし、tools/apk_pin.json に対して apksigner で検証して tools/ に配置します。また、GitHub Releases から手動でダウンロードし、tools/xcpe-scanner-tv.apk に配置することもできます。./gradlew assembleDebug でアプリをローカルにビルドすると、パイプラインはローカルビルドを検出し、明示的なセキュリティ警告とともにデバッグキーを許可します。cd app && ./gradlew assembleDebugcd app && ./gradlew testDebugUnitTestdocs/RELEASE_SIGNING.md