Skip to content
This repository has been archived by the owner on Mar 29, 2022. It is now read-only.

Commit

Permalink
Update quickstart for newer mitmproxy-HTTPolice
Browse files Browse the repository at this point in the history
  • Loading branch information
vfaronov committed Jan 14, 2017
1 parent 1e4c265 commit d4fd55e
Showing 1 changed file with 14 additions and 15 deletions.
29 changes: 14 additions & 15 deletions doc/quickstart.rst
Original file line number Diff line number Diff line change
Expand Up @@ -77,29 +77,20 @@ How do you get this into HTTPolice?

One way is to use `mitmproxy`__,
an advanced tool for intercepting HTTP traffic.
See its `installation instructions`__.
Install it in a Python 3.5+ environment with HTTPolice integration::

__ https://mitmproxy.org/
__ http://docs.mitmproxy.org/en/stable/install.html

.. note::

Another solution would be to use `Fiddler`__.
Especially Windows users may find it easier.
Use Fiddler’s `HAR 1.2 export`__ to get the data into HTTPolice.

__ http://www.telerik.com/fiddler
__ http://docs.telerik.com/fiddler/KnowledgeBase/ImportExportFormats
$ pip3 install mitmproxy-HTTPolice

You’ll need the integration package::
(see also the instructions for `installing mitmproxy from source`__).

$ pip install mitmproxy-HTTPolice
__ https://mitmproxy.org/
__ http://docs.mitmproxy.org/en/stable/install.html#advanced-installation

Now, we’re going to use mitmproxy’s command-line tool—`mitmdump`__.
The following command will start mitmdump as an HTTP proxy on port 8080
with HTTPolice integration::

$ mitmdump -s "`python -m mitmproxy_httpolice` -o html report.html"
$ mitmdump -s "`python3 -m mitmproxy_httpolice` -o html report.html"

__ http://docs.mitmproxy.org/en/latest/mitmdump.html

Expand All @@ -114,6 +105,14 @@ In the output of mitmdump, you will see that it has intercepted the exchange.
Now, when you stop mitmdump (Ctrl+C),
HTTPolice will write an HTML report to ``report.html``.

.. note::

Another such tool is `Fiddler`__. Especially Windows users may prefer it.
Use Fiddler’s `HAR 1.2 export`__ to get the data into HTTPolice.

__ http://www.telerik.com/fiddler
__ http://docs.telerik.com/fiddler/KnowledgeBase/ImportExportFormats


Django integration
------------------
Expand Down

0 comments on commit d4fd55e

Please sign in to comment.