idb is a tool to simplify some common tasks for iOS app security assessments and research. Please see the Documentationfor a more detailed summary of each function.
- Assessment Setup
- SSH port forwarding
- Installation of helper utilities
- App Information
- Bundle information
- Registered URL Schemes
- Platform and SDK Versions
- Data folder location
- Data Storage
- List plist files and data protection class
- List sqlite files and data protection class
- List Cache.db files and data protection class
- Full app file system browser
- Browse files
- Download/view files
- Check data protection
- Rsync folders and keep git revisions
- Dump iOS keychain
- Binary Analysis
- Check for encryption
- Check for protections (ASLR/PIE, DEP, ARC)
- List shared libraries
- Extract strings in app binary
- Dump class and method signatures
- List URL handlers
- Invoke and fuzz URL handlers
- Monitor the iOS pasteboardA
- Other Tools
- Check for iOS backgrounding screenshot
- Install certificates
1. Ruby Environment
idb requires a valid ruby 1.9.3 or 2.1 installation and it is recommended to install the used ruby using RVM. Ruby 2.0 does not work properly due to issues with qtbindings.
Important Note: Shared library support is required! This is the default for many system rubies, but if you install a ruby via rvm or similar, you need to do one of the following:
Under rvm use rvm install 2.1 –enable-shared when installing ruby.
Under ruby-install/chruby use — –enable-shared when installing ruby.
Under ruby-build/rbenv with ruby-build use CONFIGURE_OPTS=–enable-shared [command] when installing Ruby.
2. Install Other Prerequisites:
For OS X:
brew install qt cmake usbmuxd libimobiledevice
apt-get install cmake libqt4-dev git-core libimobiledevice-utils libplist-utils usbmuxd libxml2-dev libsqlite3-dev -y
3. Installing idb
Install idb: gem install idb
Run idb: idb
Clone the repository: git clone https://github.com/dmayer/idb
bundle install (using the right ruby version)
As for every ruby gem, the application code lives in the lib folder
Run idb by calling bundle exec idb
Note: Running bin/idb directly won’t work since it will not find the idb gem (or use the installed gem and not the checked out source code). Instead, the bundle exec command runs idb in the current bundler environment where bundler supplies the gem from source.