1. Support Center
  2. Documentation
  3. Desktop editions
  4. Tools
  5. Mobile Assistant
  6. Installing Burp Suite Mobile Assistant

Installing Burp Suite Mobile Assistant

Burp Suite Mobile Assistant is a tool to facilitate testing of iOS apps with Burp Suite. It supports the following key functions:

Note: Burp Suite Mobile Assistant needs to be installed onto a jailbroken device due to the nature of its features. Jailbreaks usually install the popular package manager Cydia which can be used to install Mobile Assistant. Advanced users may prefer to obtain Mobile Assistant directly. They can do this by pointing a web browser to Burp Suite's in-browser interface, e.g. http://[burp-host-ip]:8080/mobileassistant.deb. Although Cydia is not strictly necessary, Mobile Assistant depends on Cydia Substrate.

This tutorial demonstrates how to install Mobile Assistant using Cydia.

Launch Burp Suite on a system that is network-accessible from the jailbroken device, and ensure the proxy listener is bound to an accessible network interface and port.

Mobile assistant proxy listener

The next step is to add the instance of Burp Suite to Cydia's package sources.

On the jailbroken device, open Cydia.

Mobile assistant open Cydia

Navigate to the Sources tab.

Tap the Edit button located at the top right-hand corner.

Cydia sources tab

Tap the Add button located at the top left-hand corner.

Populate the APT URL prompt with the IP address (or hostname) and port number of your Burp Proxy listener, using HTTP as the protocol, for example, http://[burp-host-ip]:8080.

If Cydia is not able to connect, verify that your Burp Proxy listener is configured to listen on the relevant network interface, and that connections are not being blocked by your computer's host firewall or by device segregation in your wireless network.

Enter the Cydia/APT URL

Tap the Done button to finish.

Burp Suite should now appear as an individual source. Tap on the "Burp Suite Pro" option.

Burp Suite Pro source in Cydia

Install Mobile Assistant from the new Cydia package source in the normal way. Either search for Mobile Assistant or browse the new source's packages.

Install Mobile Assistant

Tap "Install".

Mobile Assistant tap install

Then tap "Confirm". When the download is complete, click "Restart Springboard".

The Mobile Assistant icon should now appear on your device.

Confirm the Mobile Assistant download

You can now begin to route traffic via Burp Suite.

Mobile Assistant routing traffic through Burp Suite