iOS-NOIR README

The project's README from github.com/arnold117/iOS-NOIR. As one markdown file: README.md.

iOS-NOIR Banner

iOS-NOIR

English · 简体中文

License: MIT Platform: macOS (Tested) No Jailbreak Required

Turn "What is my iPhone silently leaking?" into a reproducible, evidence-graded forensic report — without jailbreaking.
把「这台未越狱的 iPhone 到底在暗中泄露什么」变成一份带三级证据标注的可复现底层取证报告。

📊 Sample Standalone Interactive Report (7-Tab HTML, synthetic data): report/ios-noir-sample-report.html (fictional com.example.* apps; download & open in any browser)

💡 Acknowledgements / 致敬


⚖️ Three-Tier Evidence Grading (证据分级标准)

Following the forensic rigor of RootSir/claude-ios-privacy-analysis, iOS-NOIR explicitly distinguishes between static configuration evidence, kernel capability entitlements, and behavioral inference:


🔍 Core Findings & The 5-Layer Persistent Identity Chain

Why does turning off Allow Apps to Request to Track (IDFA), connecting to a VPN, and reinstalling an app still fail to prevent cross-app device tracking on stock iOS? iOS-NOIR audits 10+ blind spots and maps the 5-Layer Persistent Device Identity Chain:

🧬 5-Layer Persistent Identity & VPN-Bypass Chain

  1. Layer 1 — Uninstall- & New-iPhone-Proof iCloud KVS (ubiquity-kvstore-identifier) 【实锤】: Writes tracking tokens into your private iCloud key-value store that automatically restore even after app uninstallation or migrating to a brand-new iPhone.
  2. Layer 2 — Uninstall-Proof Shared Keychain (keychain-access-groups) 【实锤】: iOS Keychain items persist across app uninstalls and are shared across apps signed by the same developer Team ID.
  3. Layer 3 — Cross-App Collusion Pools (com.apple.security.application-groups) 【实锤】: Shared local storage containers (group.*) survive uninstallation as long as any single sister app from the same corporate family remains installed.
  4. Layer 4 — Hardcoded Carrier Phone-Number Gateways (cmpassport.com, wostore.cn, id6.me, 189.cn) 【实锤】: Apps that hardcode carrier one-tap-login gateways in their ATS configuration. This kind of authentication runs over cellular data, even while you're on Wi-Fi, so the carrier can identify your phone number (MDN) straight from the SIM.
  5. Layer 5 — GPS-Free Physical BSSID Hooks (HotspotHelper + its network-authentication background mode, & multicast) 【机制实锤】: System-level hooks that wake food-delivery/payment apps whenever iOS scans Wi-Fi networks, feeding them nearby router MAC addresses (BSSID).

🚨 Additional Hidden Backdoors Exposed

📝 Updates (2026-11-06)


🚀 Quick Start / 快速上手

⚠️ Platform Note: Currently tested and verified on macOS (where Apple's usbmuxd runs natively). Windows and Linux have not been tested yet (and may require additional iTunes / usbmuxd driver setup).

1. Install Dependencies

git clone https://github.com/arnold117/iOS-NOIR.git
cd iOS-NOIR
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Connect Your iPhone via USB

Plug in your iPhone, unlock the screen, and tap "Trust This Computer".

3. Run Full Audit (Terminal + Standalone 6-Tab HTML Report)

# Run full audit (outputs JSON, domains, and interactive bilingual HTML report to noir-out/)
python ios_noir.py scan

# Run in English terminal mode + redacted mode for safe sharing on X/Twitter/HN
python ios_noir.py scan --lang en --redact

# Open the generated interactive HTML report (includes top-right 🇨🇳 中文 / 🇺🇸 English switch)
open noir-out/ios-noir-report.html

4. Run Live Privacy Radar (Real-Time TCC / Sensor / IDFA Sniffer)

# Monitor real-time permission preflights, camera/mic probes, and IDFA requests for 30s
python ios_noir.py radar --duration 30

🛡️ Built-In Countermeasures (shields/)

  1. VPN-Free Kernel Encrypted DNS Shield (shields/iOS-NOIR-System-Shield.mobileconfig)
    Uses Apple's native com.apple.dnsSettings.managed payload. AirDrop it to your iPhone to block trackers and encrypt DNS over HTTPS at the OS kernel level 24/7 without keeping a VPN connected or draining battery. Automatically yields when you turn on Shadowrocket/Clash and resumes the moment VPN disconnects.
  2. 1-Click Shadowrocket / Surge Overlay Module (shields/ios_noir_shield.module & shields/ios_noir_shield.conf)
    Non-destructive overlay module for Shadowrocket / Surge / Loon / Clash (won't overwrite your main proxy config). Import directly in Shadowrocket (Config -> Modules -> +) via URL:
    https://raw.githubusercontent.com/arnold117/iOS-NOIR/main/shields/ios_noir_shield.module
    
    Blocks carrier silent-auth gateways (cmpassport.com, wostore.cn, id6.me), cross-app DNA fingerprinting (shuzilm.cn), hot-patch backdoors (jspatch.com), behavioral biometrics (online-metrix.net), and major ad-tech telemetry.

🔬 Methodology & Limitations (方法论与局限性声明)

  1. FairPlay DRM Boundary on Stock iOS: Binaries on non-jailbroken iPhones are FairPlay-encrypted. iOS-NOIR performs whole-device entitlement/plist/sandbox/syslog forensics without decrypting IPA Mach-O code sections. For function-level Ghidra decompilation of decrypted IPAs, combine iOS-NOIR with RootSir/claude-ios-privacy-analysis.
  2. Capability (【机制实锤】) ≠ Continuous Runtime Trigger (【实锤】): Holding an Apple-signed entitlement proves the kernel capability is unlocked, whereas actual trigger frequency is governed by server-side policies.
  3. Static ATS Domains ≠ Active Packet Capture: Domains listed in NSExceptionDomains are developer-declared exceptions in Info.plist; some may be legacy or conditional endpoints.

📜 Credits & License

iOS-NOIR (arnold117/iOS-NOIR)

Searching Database…

What is this?A no-jailbreak forensic auditor for iPhone. It reads entitlements, Info.plist, sandbox and syslog data over USB and writes a report on what apps may be leaking, with each finding graded by evidence strength.
Is it an app I install on my phone, or something else?Neither exactly. It's a Python command-line tool that runs on your computer and talks to the iPhone over USB, so no jailbreak is needed.
How do I get it running?Install the dependencies from the Quick Start section, plug in your unlocked iPhone, tap 'Trust This Computer' on the phone, then run the full audit to get a terminal summary and a standalone HTML report.
What do I need besides the iPhone?A Mac with Python and a USB cable. The tool is built on pymobiledevice3 for device access and rich for terminal output.
Does it decrypt app code to show what the apps do?No. Store apps are FairPlay-encrypted, so it audits entitlements, plists, sandbox and syslog without decompiling code. For function-level analysis, the README suggests pairing it with RootSir's claude-ios-privacy-analysis.
Does it work on Windows or Linux too?Not verified yet. Only macOS has been tested, where Apple's usbmuxd runs natively. Windows and Linux may need extra iTunes or usbmuxd driver setup.
What is the 5-layer persistent identity chain?The README lays out five layers that can keep tracking you across reinstalls and VPN use on stock iOS. They include iCloud key-value store, shared Keychain, App Group containers, carrier phone-number gateways and Wi-Fi BSSID hooks.
What can it learn from iOS crash logs?It parses kernel .ips logs to find apps that exceeded their 24-hour disk-write limit, ranked by how far over they went. It also flags CPU-related kills and embedded binary SDKs, all without jailbreaking.
Does it spot apps probing for my VPN or crypto wallets?Yes. It finds apps hardcoding up to 280+ URL schemes in LSApplicationQueriesSchemes to check whether VPN clients, crypto wallets or car apps are installed.
Does it come with a way to block trackers?Yes. The shields folder has a .mobileconfig that sets encrypted DNS at the OS level, plus a Shadowrocket/Surge overlay module that blocks carrier silent-auth gateways, DNA fingerprinting and ad-tech domains.
Creator
arnold117
Size
4 MB
Stars
323
Updated
CommitNov 06
Age
12d
Commits · 90 Days