iOS Dynamic Instrumentation Guide
Dynamic analysis inspects application execution in real time on a physical iOS device or simulator. This guide covers universal SSL pinning bypasses, live Keychain credential dumping, call hierarchy method tracing, and low-level LLDB breakpoint workflows.
The Dynamic Runner CLI
The suite includes a consolidated dynamic runner script that wraps battle-tested Frida payloads for USB-connected devices:
bash scripts/dynamic/run_dynamic.sh -t <target_bundle_or_process> -a <action>
1. Universal SSL Certificate Unpinning
Modern iOS applications implement pinning at multiple architectural layers: Apple Security.framework, custom BoringSSL/OpenSSL sockets, and third-party networking libraries. The suite injects hooks into all four layers simultaneously.
To bypass SSL certificate pinning in a running app:
bash scripts/dynamic/run_dynamic.sh -t com.example.app -a ssl
To spawn the process from startup with SSL unpinning active:
bash scripts/dynamic/run_dynamic.sh -t com.example.app -a ssl -s
Targeted APIs in ssl_unpinning.js:
SecTrustEvaluateandSecTrustEvaluateWithError(Security.framework)SSL_set_custom_verify(BoringSSL, WebKit, Flutter)AFSecurityPolicy evaluateServerTrust:forDomain:(AFNetworking)TSKPinningValidator evaluateTrust:forHostname:(TrustKit)URLSession:didReceiveChallenge:completionHandler:(NSURLSession)
2. Live Keychain Credential Dumping
The iOS Keychain securely stores tokens, passwords, and private keys. Intercepting Keychain queries reveals runtime secrets before encryption.
To monitor and dump all active Keychain operations:
bash scripts/dynamic/run_dynamic.sh -t com.example.app -a keychain
The script intercepts calls to SecItemAdd, SecItemCopyMatching, SecItemUpdate, and SecItemDelete, formats CFDictionary queries into JSON, and decodes base64 payload data.
3. Method Execution Hierarchy Tracing
Trace Objective-C runtime method invocations with hierarchical indentation, argument values, return values, and execution duration in milliseconds.
To trace all method calls on a specific class:
bash scripts/dynamic/run_dynamic.sh -t com.example.app -a trace -c LoginViewController
4. Method Swizzling Detection
Method swizzling replaces implementation pointers in the Objective-C runtime, frequently used by analytics SDKs, security agents, and tweaks.
To scan a binary for method swizzling call sites:
python3 scripts/dynamic/swizzling_detector.py App.app/App
To emit a live Frida script that logs all runtime swizzling calls as they happen:
python3 scripts/dynamic/swizzling_detector.py App.app/App --emit-frida
5. Low-Level Live Debugging with LLDB
For instruction-level execution control or kernel anti-debugging evasion, use LLDB connected to debugserver over USB multiplexing.
Forward debugserver port over USB:
iproxy 1234 1234 &
Attach debugserver on the iOS device:
debugserver *:1234 -a TargetApp
Connect LLDB from macOS:
lldb
(lldb) platform select remote-ios
(lldb) process connect connect://localhost:1234
(lldb) image list -o -f TargetApp
Calculate target breakpoints by adding the ASLR slide offset to the target virtual address:
(lldb) breakpoint set -a "0x100000000 + 0x145a20"
(lldb) register read x0 x1 pc
(lldb) continue