// CLI
apksonar
Пакет apksonar в npm оборачивает весь REST API. Ноль зависимостей, Node 18+, один бинарник поведения: загрузил, дождался, разобрал JSON.
Install from npmjs.com/package/apksonar or read the sources at github.com/matestani/apksonar-tools
npm i -g apksonar curl -O https://apksonar.com/tools/apksonar.mjs && node apksonar.mjs scan app.apk
КОМАНДЫ
Цикл скана
Четыре команды закрывают весь цикл:
apksonar scan app-release.apk --mode fast --wait apksonar scan app-release.apk --mode deep --wait # Ghidra native pass apksonar status 42 apksonar report BCh8dT6Lg3VbLHqXz0ZT70DL
ОКРУЖЕНИЕ
Переменные
Три переменные окружения; ключ берётся в кабинете:
export APKSONAR_URL=https://apksonar.com export APKSONAR_KEY_ID=apk_mcp_… export APKSONAR_SECRET=…
КОДЫ ВЫХОДА
Для конвейеров
Коды выхода для CI: 0 чисто или успешно завершено, 1 ошибка запроса, 2 скан прошёл, но есть critical или high находки. Это позволяет ронять сборку прямо по коду.
РЕЦЕПТЫ CI
Готовые пайплайны
GitHub Action на npx:
# .github/workflows/security.yml
name: apk-security
on: [push]
jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: ./gradlew assembleRelease
- name: APKSonar scan
env:
APKSONAR_URL: https://apksonar.com
APKSONAR_KEY_ID: ${{ secrets.APKSONAR_KEY_ID }}
APKSONAR_SECRET: ${{ secrets.APKSONAR_SECRET }}
run: |
npx --yes apksonar scan app/build/outputs/apk/release/app-release.apk \
--mode fast --wait --out apksonar.json
- uses: actions/upload-artifact@v4
if: always()
with: { name: apksonar-report, path: apksonar.json }GitLab CI
GitLab на голом curl (ключ v1):
# .gitlab-ci.yml
apk_security:
stage: test
image: curlimages/curl:latest
script:
- ID=$(curl -s -X POST https://apksonar.com/api/v1/scans
-H "Authorization: Bearer $APKSONAR_KEY"
-F "[email protected]" | sed -n 's/.*"id":\([0-9]*\).*/\1/p')
- until curl -s https://apksonar.com/api/v1/scans/$ID -H "Authorization: Bearer $APKSONAR_KEY" | tee r.json | grep -q '"status":"done\|failed"'; do sleep 10; done
- grep -q '"critical":0' r.json && grep -q '"high":0' r.json