Quickstart

A customizable man-in-the-middle TCP proxy with support for HTTP & HTTPS.

---

Installing

pip install mitm

Note that OpenSSL 1.1.1 or greater is required.

Using

Using the default values for the mitm.MITM class:

from mitm import MITM, protocol, middleware, crypto

mitm = MITM(
    host="127.0.0.1",
    port=8888,
    protocols=[protocol.HTTP],
    middlewares=[middleware.HTTPLog],
    certificate_authority = crypto.CertificateAuthority()
)
mitm.run()

This will start a proxy on port 8888 that is capable of intercepting all HTTP traffic (with support for SSL/TLS) and log all activity.

Questions & Answers

How does this project differ from mitmproxy ?

Purpose, implementation, and customization style. The purpose of mitm is to be a light-weight customizable man-in-the-middle proxy intended for larger projects. mitmproxy (with its beautiful CLI) seems to be more for interactive request and response tampering and capturing. While it does support everything mitm does plus more, it lacks the simplicity that mitm has.

What protocols are supported out-of-the-box?

Only HTTP/1.0 and HTTP/1.1 are supported. Any other protocol (FTP, SMTP, etc.) will require a custom implementation. Any protocol that is built on top of HTTP/1.1 (e.g. websockets) should in theory work.