Rooba
/
mitmproxy
mirror of https://github.com/mitmproxy/mitmproxy.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
An interactive TLS-capable intercepting HTTP proxy for penetration testers and software developers.
161 Commits 9 Branches 108 Tags 92 MiB
Python 81.5%
TypeScript 13.4%
JavaScript 3.6%
Less 0.9%
HTML 0.3%
Other 0.2%
Go to file
Aldo Cortesi 2f457e041e Unify mitmproxy and mitmdump commandline 
- Extract common options into cmdline.py
- Change mitmproxy keybindings to fit command line

Some cmdline options and keybindings aren't in operation yet - just stubs
where functionality will be added in the next few commits.
 		2011-03-12 14:30:12 +13:00
doc-src Stub out doc structure, add screenshots for configuring certs in Firefox. 2011-02-19 19:43:44 +13:00
examples First pass of script hooks for mitmdump. 2011-02-18 12:40:45 +13:00
libmproxy Unify mitmproxy and mitmdump commandline 2011-03-12 14:30:12 +13:00
test Make mitmdump handle invalid serialized data gracefully. 2011-03-11 15:16:31 +13:00
.gitignore Simple record & playback functionality 2011-02-10 02:59:51 +01:00
CHANGELOG Release mitmproxy 0.2 2010-03-01 17:25:27 +13:00
LICENSE Initial checkin. 2010-02-16 17:09:07 +13:00
MANIFEST.in Initial checkin. 2010-02-16 17:09:07 +13:00
README.mkd Make README reflect reality. 2011-02-21 12:11:41 +13:00
mitmdump Unify mitmproxy and mitmdump commandline 2011-03-12 14:30:12 +13:00
mitmproxy Unify mitmproxy and mitmdump commandline 2011-03-12 14:30:12 +13:00
setup.py Fix setup.py 2011-02-21 12:04:24 +13:00
todo Add -c and -C options to mitmdump to control sticky cookies. 2011-02-25 17:32:03 +13:00

README.mkd

mitmproxy is an interactive SSL-capable intercepting HTTP proxy. It lets you to observe, modify and replay requests and responses on the fly. The underlying library that mitmproxy is built on can also be used to do these things programmatically.

By default, mitmproxy starts up with a mutt-like interactive curses interface - the built-in help page (which you can view by pressing "?") will tell you everything you need to know. Note that requests and responses are stored in-memory until you delete them, so leaving mitmproxy running indefinitely or requesting very large amounts of data through it is a bad idea.

SSL

The first time mitmproxy is started, it will generate a bogus SSL certificate authority (the default location is ~/.mitmproxy/ca.pem). This CA is used to generate certificates for SSL requests on-the-fly. To avoid the hassle of having to accept these certificates individually, you can add the certificate authority to your browser or globally to your system.

Documentation

A rendered version of the docs for the latest release can be found here:

http://corte.si/projects.html

Download

Releases can be found here: http://corte.si/projects.html

Source is hosted here: http://github.com/cortesi/mitmproxy

Requirements

  • A recent Python interpreter.
  • SSL certificates are generated using openssl
  • The curses interface relies on version 0.9.8 or newer of the urwid library.
  • The test suite uses the pry unit testing library.

You should also make sure that your console environment is set up with the following:

  • EDITOR environment variable to determine the external editor.
  • PAGER environment variable to determine the external pager.
  • Appropriate entries in your mailcap files to determine external viewers for request and response contents.