apk-processor

Download APK files (Android Application), analyze them and extract REST API calls.

Overview

This service is a Surface Crawler processor. It consumes CrawlResponse messages from the apk-processor-responses SQS queue (subscribed to the crawl-responses SNS topic), processes artifacts of kind KindLinks, and publishes results back into the crawler pipeline.

See the Processor SDK docs for the full SDK reference.

Development

make build/local   # build
make test/unit     # unit tests
make lint          # lint

Deployment

Environment-specific configuration lives in .deploy/. Research deploys automatically on every push to master. Other environments deploy via the Secful/salt-cicd reusable workflow.

See .claude/skills/cicd/SKILL.md for the full CI/CD diagram.

Architecture

• internal/processor/processor.go — business logic entry point (ProcessPage)
• internal/app/app.go — wires crawl-common SDK, messaging, and metrics
• internal/config/default.yaml — service defaults
• .deploy/ — per-environment Helm values
• infrastructure/terraform/ — SQS queue + IAM role Terraform stubs (copy into Secful/terraform)