aboutsummaryrefslogtreecommitdiffstats
path: root/docs/features/passthrough.rst
diff options
context:
space:
mode:
authorMaximilian Hils <git@maximilianhils.com>2016-06-06 19:08:46 -0700
committerMaximilian Hils <git@maximilianhils.com>2016-06-06 19:10:19 -0700
commit83f852298132ef6c3757cdc10a34f237a2df33ab (patch)
tree891a880b85d8ca06ffb07405464fd0c5745d78b7 /docs/features/passthrough.rst
parent9a1cc166434a505a18e48501d96cb0081601f99e (diff)
downloadmitmproxy-83f852298132ef6c3757cdc10a34f237a2df33ab.tar.gz
mitmproxy-83f852298132ef6c3757cdc10a34f237a2df33ab.tar.bz2
mitmproxy-83f852298132ef6c3757cdc10a34f237a2df33ab.zip
docs: remove option directive
inserting " .. option::" tags create ugly markup, so we just ditch this entirely and continue using refs.
Diffstat (limited to 'docs/features/passthrough.rst')
-rw-r--r--docs/features/passthrough.rst10
1 files changed, 5 insertions, 5 deletions
diff --git a/docs/features/passthrough.rst b/docs/features/passthrough.rst
index b7b5df84..ea628dad 100644
--- a/docs/features/passthrough.rst
+++ b/docs/features/passthrough.rst
@@ -20,10 +20,10 @@ take a look at the :ref:`responsestreaming` feature.
How it works
------------
-================== =============================
-command-line :option:`--ignore regex`
+================== ======================
+command-line ``--ignore regex``
mitmproxy shortcut :kbd:`o` then :kbd:`I`
-================== =============================
+================== ======================
mitmproxy allows you to specify a regex which is matched against a ``host:port`` string
@@ -32,7 +32,7 @@ mitmproxy allows you to specify a regex which is matched against a ``host:port``
There are two important quirks to consider:
- **In transparent mode, the ignore pattern is matched against the IP and ClientHello SNI host.** While we usually infer the
- hostname from the Host header if the :option:`--host` argument is passed to mitmproxy, we do not
+ hostname from the Host header if the ``--host`` argument is passed to mitmproxy, we do not
have access to this information before the SSL handshake. If the client uses SNI however, then we treat the SNI host as an ignore target.
- In regular mode, explicit HTTP requests are never ignored. [#explicithttp]_ The ignore pattern is
applied on CONNECT requests, which initiate HTTPS or clear-text WebSocket connections.
@@ -42,7 +42,7 @@ Tutorial
If you just want to ignore one specific domain, there's usually a bulletproof method to do so:
-1. Run mitmproxy or mitmdump in verbose mode (:option:`-v`) and observe the ``host:port``
+1. Run mitmproxy or mitmdump in verbose mode (``-v``) and observe the ``host:port``
information in the serverconnect messages. mitmproxy will filter on these.
2. Take the ``host:port`` string, surround it with ^ and $, escape all dots (. becomes \\.)
and use this as your ignore pattern: