pymiproxy Python Micro Interceptor Proxy
Download

pymiproxy Ranking & Summary

pymiproxy Tags

proxy HTTP HTTPS HTTP proxy HTTPS proxy

pymiproxy Description

pymiproxy is a small and sweet man-in-the-middle proxy capable of doing HTTP and HTTP over SSL.Introductionpymiproxy is a small, lightweight, man-in-the-middle proxy capable of performing HTTP and HTTPS (or SSL) inspection. The proxy provides a built-in certificate authority that is capable of generating certificates for SSL-based destinations. Pymiproxy is also extensible and provides two methods for extending the proxy: method overloading, and a pluggable interface. It is ideal for situations where you're in dire need of a cool proxy to tamper with out- and/or in-bound HTTP data.InstallationJust run the following command at the command prompt: sudo python setup.py installUsageThe module offers a few examples in the code. In brief, pymiproxy can be run right-away by issuing the following command at the the command-prompt: python -m miproxy.proxyThis will invoke pymiproxy with the DebugInterceptor plugin which simply outputs the first 100 bytes of each request and response. The proxy runs on port 8080 and listens on all addresses. Go ahead and give it a try.Extending or Implementing pymiproxyThere are two ways of extending the proxy:- Develop and register an Interceptor plugin; or- Overload the mitm_request, and mitm_response methods in the ProxyHandler class.The decision on which method you choose to use is entirely dependant on whether or not you wish to push the data being intercepted through a set of interceptors or not.Interceptor PluginsThere are currently two types of interceptor plugins:- RequestInterceptorPlugins: executed prior to sending the request to the remote server; and- ResponseInterceptorPlugins: executed prior to sending the response back to the client.The following flow is taken by pymiproxy in this mode:1. Client request received2. Client request parsed3. Client request processed/transformed by Request Interceptor plugins4. Updated request sent to remote server5. Response received by remote server6. Response processed/transformed by Response Interceptor plugins7. Updated response sent to clientYou can register as many plugins as you wish. However, keep in mind that plugins are executed in the order that they are registered in. Take care in how you register your plugins if the result of one plugin is dependent on the result of another.The following is a simple code example of how to run the proxy with plugins:from miproxy.proxy import RequestInterceptorPlugin, ResponseInterceptorPlugin, AsyncMitmProxyclass DebugInterceptor(RequestInterceptorPlugin, ResponseInterceptorPlugin): def do_request(self, data): print '>> %s' % repr(data) return data def do_response(self, data): print '> %s' % repr(data) return data def mitm_response(self, data): print 'Product's homepage

pymiproxy Related Software