Skip to content

Latest commit

 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AppEnumGuard

AppEnumGuard is a defensive tweak for the installed-application enumeration side channel tracked as CVE-2025-31207. It supports conventional rootless and rootHide jailbreak environments on iOS 15.0–18.4.1. The repository also contains a normal sandboxed iOS test application that demonstrates the vulnerable result and verifies the mitigation.

CVE-2025-31207

CVE-2025-31207 is an information-disclosure vulnerability in Apple's FrontBoard application-launching logic. A sandboxed application can submit arbitrary bundle identifiers through a private SpringBoardServices launch function and distinguish installed applications from missing applications using different return codes. This can reveal private information about the applications a user has installed, including banking, messaging, security, sideloading, and jailbreak-related apps.

Apple describes the issue as a logic problem that could let an application enumerate installed apps. Apple corrected it with improved checks in iOS and iPadOS 18.5. Consequently, systems earlier than iOS 18.5 remain affected at the OS level.

Compatibility

Component Supported target
iOS 15.0–18.4.1
Jailbreak Any conventional rootless or rootHide jailbreak environment
Bootstrap/package architecture rootless / iphoneos-arm64; rootHide / iphoneos-arm64e
Device architecture arm64 and arm64e (rootless); arm64e (rootHide)
Package Install the package matching the device's bootstrap

The default build uses conventional rootless Theos and includes arm64 and arm64e slices. The rootHide variant is built with rootHide Theos and contains the required rootHide .jbroot loader paths. Both packages declare firmware (>= 15.0) and firmware (<< 18.5): the mitigation is unnecessary on iOS 18.5 and newer, where Apple fixed CVE-2025-31207.

The SpringBoard-side v1.1 tweak and sandboxed tester were verified together on iOS 17.3.1 build 21D61 with injection disabled for the tester. The tester detected the leak with the tweak removed and returned a green pass after the tweak was installed.

How it works

The published primitive calls the private SpringBoardServices function SBSLaunchApplicationWithIdentifierAndURLAndLaunchOptions. On a vulnerable system it returns different errors for an installed application and a missing application:

  • 9: target exists, but launch is denied by policy
  • 7: target does not exist

AppEnumGuard 1.1 injects only into SpringBoard and hooks the common FBSystemService trust-validation method. When an unauthorized launch request would return FBSOpenApplicationErrorDomain security-policy error 3, the tweak changes it to application-not-found error 4. The outer SpringBoardServices API then returns 7 for both installed and missing targets.

The private method's argument count and Objective-C type encoding are validated before the hook is installed. If Apple changes the ABI, AppEnumGuard fails open instead of hooking an unknown SpringBoard method.

Change from 1.0

Version 1.0 hooked SpringBoardServices inside every UIKit application. It worked, but required injection into every app being protected; an app that disabled or detected injection could bypass the mitigation. Version 1.1 moves enforcement to SpringBoard, so a single central hook protects callers without injecting AppEnumGuard into their processes.

Release downloads

Release 1.2 can be built for either bootstrap:

  • AppEnumGuard_1.2_rootless_iphoneos-arm64.deb — conventional rootless tweak
  • AppEnumGuard_1.2_roothide_iphoneos-arm64e.deb — rootHide tweak
  • AppEnumGuardTester_1.2_sandboxed.ipa — sandboxed verification app with icon

Install and verify

  1. Install the .deb matching the rootless or rootHide bootstrap and respring.
  2. Install the tester IPA using a normal developer/sideloading signature.
  3. Leave AppEnumGuard injection disabled for AppEnum Test; v1.1 protects it from SpringBoard.
  4. Tap the icon for an app you know is installed. Presets are available for WhatsApp, YouTube, Spotify, Dopamine, TrollStore, and Reddit.

Expected results with the selected target installed:

State Target Missing Tester result
Tweak absent 9 7 Red / FAIL
Tweak active 7 7 Green / PASS

The tester reports red only for the known vulnerable 9 / 7 result and green for every other numeric result; a red result states that AppEnumGuard is not installed. Green results are labeled App not detected. The vulnerable 9 / 7 result is labeled App detected and AppEnumGuard missing. Select only an app you know is installed: 7 / 7 alone cannot distinguish a working mitigation from a target that does not exist.

The tester also includes a short project description and a clickable link to this GitHub repository.

The device test reproduced both states with tester injection disabled: uninstalling the tweak produced the red 9 / 7 result, while installing v1.1 produced the green 7 / 7 result.

Build the tweak

With standard Theos, the default build is conventional rootless:

cd Tweak
make clean package FINALPACKAGE=1

For rootHide, install rootHide Theos and run:

cd Tweak
THEOS=/path/to/theos-roothide \
  make clean package FINALPACKAGE=1 THEOS_PACKAGE_SCHEME=roothide

Build the tester IPA

The tester is compiled with Xcode's iPhoneOS SDK and has no jailbreak or elevated entitlements:

./scripts/build-tester-ipa.sh

The resulting IPA is placed in dist/. It is ad-hoc signed so an installer may re-sign it with a normal development identity. Do not grant it platform-application or com.apple.private.security.no-sandbox, since the test is specifically intended to run from a normal application sandbox.

Scope and limitations

  • This is a user-space mitigation for the published SpringBoardServices primitive, not Apple's complete FrontBoard patch.
  • Version 1.1 does not require injection into protected applications. Disabling injection globally or for SpringBoard itself will disable the mitigation.
  • The server-side implementation is confirmed on iOS 17.3.1 build 21D61. On other supported versions, the tweak installs its hook only when the private selector has the expected runtime-validated ABI.
  • A 7 / 7 test is meaningful only when the target application is known to be installed.
  • The tester intentionally calls an undocumented private API and is not suitable for App Store submission.

References

License

MIT

About

CVE-2025-31207 mitigation and sandboxed tester for rootless and rootHide jailbreaks on iOS 15–18.4.1

Topics

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages