ENСканировать

// 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

Формат ответов API →