Skip to content

Latest commit

 

History

History
76 lines (48 loc) · 2.17 KB

install.md

File metadata and controls

76 lines (48 loc) · 2.17 KB
Raw

Install

  1. Install from Homebrew or from source
  2. Setup certificates

Install from Homebrew

The preferred way for OSX is to use the Homebrew tap. The first time:

brew tap ustwo/tools
brew install mastermind

To upgrade just brew update and brew upgrade mastermind.

Install from source

Requirements

  • Python (tested with version 2.7).
  • pip.
  • OSX if you want to use the proxyswitch tool.
  • xcode-select --install if you use OSX.
pip install "git+https://github.com/ustwo/[email protected]#egg=mastermind"

Setup certificates

You must follow this step for every device and simulator/emulator you want to use. If you don't do it your HTTPS requests will not be properly intercepted.

This section explains how to do the quick setup to install mitmproxy certificates. If you want other certificates, please read mitmproxy "About Certificates".

Quoting the mitmproxy documentation:

[...] just start mitmproxy and configure your target device with the correct proxy settings. Now start a browser on the device, and visit the magic domain mitm.it.

If you installed Mastermind from source, follow mitmproxy's documentation. If you installed Mastermind via Hombrew, start Mastermind like:

sudo mastermind --with-driver --source-dir .

and then visit the magic mitm.it domain.

Either way, remember to set the proxy settings for your device so the magic can happen.

Pinned HTTPS certificates

There are issues with Certificate Pinning. In depth: TACK.

If you are able to provide proper certificates for the domain you are intercepting, use the --cert or --cadir flags as suggested by mitmproxy.