Installation Guide

Marco Lancini edited this page Aug 7, 2017 · 20 revisions

Device Setup

Prerequisites

The only prerequisite is a Jailbroken device, with the following packages installed:

  • Cydia
  • Apt 0.7 Strict

(For non-essential prerequisites, please refer to Device Dependencies.)

Install the Needle Agent

  • If the setup process is successful, you'll find the NeedleAgent app on the home screen

Workstation Setup

Get a copy of Needle

git clone https://github.com/mwrlabs/needle.git

Install Dependencies

Kali
# Unix packages
sudo apt-get install python2.7 python2.7-dev sshpass sqlite3 lib32ncurses5-dev

# Python packages
sudo pip install readline paramiko sshtunnel frida mitmproxy biplist
OS X
# Core dependencies
brew install python
brew install libxml2
xcode-select --install

# Python packages
sudo -H pip install --upgrade --user readline
sudo -H pip install --upgrade --user paramiko
sudo -H pip install --upgrade --user sshtunnel
sudo -H pip install --upgrade --user frida
sudo -H pip install --upgrade --user biplist

# sshpass
brew install https://raw.githubusercontent.com/kadwanev/bigboybrew/master/Library/Formula/sshpass.rb

# mitmproxy
wget https://github.com/mitmproxy/mitmproxy/releases/download/v0.17.1/mitmproxy-0.17.1-osx.tar.gz
tar -xvzf mitmproxy-0.17.1-osx.tar.gz
sudo cp mitmproxy-0.17.1-osx/mitm* /usr/local/bin/

Start the Framework

See the Quick Start Guide.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.