安全測試套件 Trade Federation (sts-tradefed) 是建構在 Android Trade Federation 測試套件之上,可測試所有 Android 裝置,以便進行不屬於相容性測試套件的安全性修補程式測試。這些測試僅適用於與常見安全漏洞與資料外洩風險 (CVE) 相關 (或將相關) 的修正程式。
這個 SDK 可讓您使用 Android Studio 或標準 Android SDK,在 Android 來源樹狀結構之外開發 STS 測試。其中包含建構及執行 STS 測試所需的所有公用程式。
必要條件
- 64 位元 Linux 電腦。
- Android Studio (也可以透過發行的套件管理員安裝)。
- 您必須安裝 Android 平台工具 (
adb
、fastboot
),並將其放在$PATH
中 (也就是說,您應該可以透過指令列執行adb
)。如要安裝平台工具,最簡單的方法是透過發布板的套件管理工具。- 如果使用 Android Studio 的 SDK Manager,而非獨立的平台工具,請記得將 SDK 的
platform-tools
目錄新增至 $PATH。
- 如果使用 Android Studio 的 SDK Manager,而非獨立的平台工具,請記得將 SDK 的
- aapt,也可以透過發布版本的套件管理工具安裝。
開始使用 Android Studio
解壓縮封存檔後,請在 Android Studio 中將目錄設為現有專案。根據目標 Android 裝置的架構,執行 assembleSTSARM
或 assembleSTSx86
建構目標來建構架構測試。執行 runSTS
建構目標,即可在已連結的裝置上執行骨架測試 (必須授權 ADB)。
開始使用 Gradle
擷取封存檔後,請在 Gradle 專案根目錄的 local.properties
檔案中設定 sdk.dir
屬性,然後執行 assembleSTSARM
Gradle 工作來建構骨架測試。建構完成後,要執行測試,方法是前往 (cd
) 加入 build/android-sts/tools
並執行 sts-tradefed
包裝函式。
$ echo 'sdk.dir=/home/<myusername>/Android/Sdk' > local.properties
$ ./gradlew assembleSTSARM
$ cd build/android-sts/tools
$ ./sts-tradefed run sts-dynamic-develop -m hostsidetest
編寫 STS 測試
STS 測試包含三個部分:
- 透過 ADB 與裝置互動的主機端交易測試,位於
sts-test
子目錄。 - 一種選用的原生概念驗證攻擊,會透過
adb push
推送至裝置,並透過native-poc
子目錄中的主機端測試執行。 - 透過
adb install
安裝在裝置上,且由主機端測試啟動的選用應用程式或服務 APK。應用程式或服務也可以包含自己的 JUnit 斷言組合,並回報給主機端執行程式。這個檔案位於test-app
子目錄中。
典型的 STS 測試流程通常會遵循下列兩種模式之一:
原生概念驗證:
- 主機端測試會在裝置上推送及啟動原生可執行檔。
- 原生程式異常終止或傳回特定的結束代碼。
- 主機端測試會檢查當機情形、查看 logcat 回溯追蹤,或查看特定結束碼,以判斷攻擊是否成功。
檢測設備測試應用程式:
- 主機端測試會將包含應用程式或服務的 APK 推送至裝置。
- 主機端測試會透過
runDeviceTest()
啟動 APK 隨附的裝置端 JUnit 測試 - 裝置端的 JUnit 測試輕觸按鈕,並使用 UIAutomator 監控應用程式,或以揭露安全漏洞的方式存取 Android 系統。
- 裝置端 JUnit 測試的成功或失敗結果會傳回至主機端測試,可用於判斷測試是否通過。
此外,也可以結合兩種模式 (例如,搭配裝置端測試執行原生程式)。您也可以使用其他一些檢測架構,例如 frida-inject
。詳情請參閱安全測試套件參考文件和交易參考文件。
概念驗證攻擊不需要測試應用程式或原生執行檔
大多數測試都不需要同時使用裝置端應用程式和原生執行檔。
如果測試不涉及使用裝置端應用程式/服務,請直接刪除 test-app
子目錄。同樣地,如果您的測試並未使用原生執行檔,請刪除 native-poc
子目錄,然後用 Gradle 同步處理專案。專案會在這些模組不存在時,自動略過建構這些模組。
我的概念驗證攻擊涉及第二個應用程式/服務
首先,在專案中為第二個應用程式/服務新增模組,並編寫方式與任何其他 APK 相同。
接著,請編輯這個目錄根目錄中的 build.gradle
,並按照 copyArtifacts
、assembleStsARM
和 assembleStsx86
中的操作說明新增模組。這樣做可確保已編譯的 APK 會複製到 STS 的輸出目錄,並在測試中安裝/呼叫新應用程式。
最後,Gradle 會同步處理專案。
提交 STS 測試
執行 zipForSubmission
工作 (透過 Android Studio 或在指令列使用 Gradle)。新檔案 codesubmission.zip
應在專案根目錄的 build
目錄中建立。請將該檔案與提交至 Android 安全漏洞獎勵計畫的內容一併上傳。