mcpField
M
mobile-security

mobile-security

github.com/transilienceaiSecurity600179 installsUpdated 13w ago
Repository

About mobile-security

An end-to-end VAPT skill for Android and iOS apps, organized around OWASP MASVS and MASTG. It prioritizes static package analysis, adds runtime testing where controls require it, and pivots from recovered app endpoints to backend testing.

Key features

  1. 01Android APK/AAB and iOS IPA analysis
  2. 02Static reverse engineering and SAST
  3. 03Frida-based dynamic testing
  4. 04Privacy and data-collection review
  5. 05Backend testing from recovered endpoints

Use cases

  1. 01Inspect app packages for secrets, endpoints, and crypto logic
  2. 02Test runtime controls such as TLS pinning and jailbreak detection
  3. 03Review trackers, personal-data leakage, and privacy declarations
  4. 04Recover client endpoints and assess server-side risks

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/transilienceai/communitytools --skill mobile-security

After installing, type/mobile-securityin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

reference/
android-dynamic-analysis.md
android-static-analysis.md
flutter-aot-reversing.md
ios-dynamic-analysis.md
ios-static-analysis.md
masvs-class-map.md
methodology.md
privacy-testing.md
reference/scenarios/android/
native-lib-host-extraction.md
react-native-hermes.md

Details

From the project README

Mobile Security

Scope

End-to-end mobile application VAPT for Android (APK/AAB) and iOS (IPA), aligned to the OWASP MASVS v2.x control groups and the MASTG testing process. Four complementary tiers:

  1. Static reverse engineering of compiled artifacts — Dart AOT snapshots, Unity IL2CPP, React Native/Hermes bytecode, native ARM64 .so/Mach-O, smali. Recover secrets, endpoints, and the crypto contract without a device.
  2. SAST — manifest / Info.plist, exported-component & IPC surface, WebView, local storage, cryptographic-primitive weakness, code-signing, and automated baseline (MobSF/apkid/apkleaks) → then manual deep-dive.
  3. Dynamic analysis (DAST) — Frida/objection instrumentation, traffic interception, TLS-pinning bypass across stacks, Keychain/Keystore runtime dumps, IPC probing, and root/jailbreak/anti-tamper defeat for MAS-L2 / MASA scope.
  4. Privacy — data-collection inventory, tracker/SDK enumeration, PII leakage, declared-vs-actual (Play Data Safety / Apple Privacy Manifest).

Static dump first (faster, no device); dynamic is a first-class phase whenever a control can only be proven at runtime (enforced pinning, Keystore-backed keys, root reaction, IPC guards). Cross-asset stitching, scoring, and reporting are owned by sibling skills — this skill produces MASVS/MASTG-tagged findings and hands them off.

Coverage contract

In a coverage-mode engagement (pentest-engagement mobile mode) completion is code-enforced, not narrative. Two surfaces are gated, and both are mandatory:

SurfaceFileClasses
The app bundlerecon/inventory/mobile-surface.jsonthe 15 MAS-* MASVS classes
The backend recovered from the bundle<apex>-api/recon/inventory/surface.jsonthe ordinary OWASP API/web classes

The second row is where the material risk has historically been. A decompiled bundle hands you the full server contract, and that surface is not browser-reachable — so it is systematically under-tested by everyone, including the app's own developers. Recovering the endpoint inventory and driving it through the API classes is not an optional extra; a bundle that yields zero endpoints is treated as a failed acquisition.

Per-class detail: reference/masvs-class-map.md. Two rules worth internalising before you write a negative:

  • proof_mode: runtime cannot be closed statically. Pinning and root detection are the classic traps: static analysis can prove a control is inert (a CertificatePinner built and never attached, a RootBeer that no DEX references) — raise that as a positive. It can never prove the control is effective; that needs a bypass attempt that failed, and a failed bypass is a legitimate, reportable result.
  • proof_mode: static can never be device-deferred. No device does not excuse the manifest, the signature, the bundled dependencies, or the secrets in the artifact.

When to use

  • Target ships an Android APK/AAB or iOS IPA — extract and inspect before any runtime testing.
  • Built with Flutter (lib/arm64-v8a/libapp.so / iOS App.framework), Unity (libil2cpp.so + global-metadata.dat), or React Native + Hermes (libhermes.so + index.android.bundle) — needs a runtime-aware decompiler, not just jadx.
  • Stock Android/iOS app — you need the manifest/IPC/storage/crypto/signing attack surface (SAST) and, where a control is runtime-only, dynamic confirmation.
  • App uses encrypted API envelopes (KEY/IV/SALT/SIGNATURE headers) and you need to reverse the crypto contract, then replay against the live API.
  • TLS pinning / root / jailbreak detection blocks testing — bypass it dynamically (or defeat it statically) and demonstrate the protected flow.
  • You suspect IDOR / mass assignment / business-logic flaws easier to find in the dumped client, then confirmed server-side.
  • You need a MASVS-PRIVACY pass (trackers, over-collection, PII leakage, declared-vs-actual).

Methodology

Start at reference/methodology.md — the phase backbone (ACQUIRE → TRIAGE → STATIC → DYNAMIC → NETWORK → STORAGE → PLATFORM/IPC → BACKEND PIVOT → REPORT), app acquisition + evidence integrity, the MASVS→file coverage map, finding-tagging convention, and the client→API pivot. It routes to every reference below. Do preflight (../coordination/reference/preflight-checklist.md) first.

References

Cross-cutting

Android

  • reference/android-static-analysis.md — SAST: MobSF/apkid/apkleaks baseline, manifest & exported-component/IPC, ContentProvider SQLi/traversal, PendingIntent, deep links, native WebView RCE, storage & Keystore review, crypto-primitive weakness pass, NSC, apksigner/Janus, SBOM.
  • reference/android-dynamic-analysis.md — DAST: device/Magisk/Zygisk setup, frida-server bring-up, objection recipes, interception + Android-7 user-CA workarounds, cross-stack pinning bypass (OkHttp/BoringSSL-Flutter/RN), drozer IPC, runtime storage, RESILIENCE active bypass + repack/resign.

iOS

  • reference/ios-static-analysis.md — SAST: IPA acquisition + FairPlay decrypt (cryptid), Mach-O/ObjC/Swift RE, ATS, entitlements/provisioning, binary hardening, Keychain accessibility + Data Protection, URL schemes/Universal Links, WKWebView, pasteboard/snapshot, MobSF/SBOM.
  • reference/ios-dynamic-analysis.md — DAST: jailbroken vs non-JB (objection patchipa / frida-gadget) bring-up, objection/Frida on iOS, SSL Kill Switch / SecTrust pinning bypass, Keychain dump, LAContext biometric bypass, jailbreak/anti-debug defeat, method tracing.

Framework-specific reverse engineering

Cross-skill (reused capabilities — cross-linked, not duplicated)

Deterministic control-wiring detector

  • ../../tools/apk_control_wiring.py — static cross-reference over a decompiled Android tree that distinguishes a REAL applied control from an ORPHANED one: RootBeer/SafetyNet/Play-Integrity shipped-but-unwired (referenced but the result gates nothing), CertificatePinner built-but-not-attached to an OkHttpClient, hardcoded AES/DES key literals + their invoke-sites, and bundled-but-never-loaded .so. Run it in the STATIC phase BEFORE authoring remediation verdicts — a naive re-test that only greps for the control's presence wrongly reports an inert control "fixed" (a recurring mobile re-test crux).

Anti-patterns

  • Reaching for Frida/emulator before the static dump exists — static-first is faster and needs no device. But do not treat dynamic as out of scope: pinning enforcement, Keystore binding, root reaction, and IPC reachability are runtime-only.
  • Reporting a control as present (root/pinning/tamper detection) without an active bypass attempt — MAS-L2 / MASA require you defeat it or prove you can't.
  • Concluding "no pinning" from an empty network_security_config.xml, or "no secrets" from a cryptid 1 iOS binary — check the JS/native pin layers, and decrypt the IPA first.
  • Stopping at a client-side IDOR — it is a server-side hypothesis; confirm via the api-security pivot.
  • Reporting a CVE from a library's mere presence — confirm the exact version and a reachable code path.

Comments

Markdown supported