diff --git a/source/_posts/mitmproxy.md b/source/_posts/mitmproxy.md index b1d497f..41de9d3 100644 --- a/source/_posts/mitmproxy.md +++ b/source/_posts/mitmproxy.md @@ -3,24 +3,24 @@ title: Mitmproxy date: 2020-12-22 20:10:08 background: bg-[#d86138] tags: - - capture - - traffic - - network - - utility + - capture + - traffic + - network + - utility categories: - - Toolkit + - Toolkit intro: | - [mitmproxy](https://mitmproxy.org/) is a free and open source interactive HTTPS proxy. This is a quick reference cheat sheet to the mitmproxy. + [mitmproxy](https://mitmproxy.org/) is a free and open source interactive HTTPS proxy. This is a quick reference cheat sheet to the mitmproxy. plugins: - - copyCode + - copyCode --- -Getting Started ---------------- +## Getting Started ### Usage {.col-span-2} + | Option | Example | Description | -|--------|----------------------------------------------------|-------------------------------------------| +| ------ | -------------------------------------------------- | ----------------------------------------- | | `-p` | mitmproxy -p 8001 | Start proxy on port 8001 | | `-m` | mitmproxy -p 8001 -m reverse:http://127.0.0.1:4000 | Reverse proxy on port 8001 to port 4000 | | `-w` | mitmproxy -p 8001 -w traffic.mitm | Stream flows to file as they arrive | @@ -30,79 +30,82 @@ Getting Started | `-s` | mitmproxy -s myScript.py | Execute a script | | `-h` | mitmproxy -h | mitmproxy quick help | +### Movement -### Movement -```markdown +``` k Ctrl b ▲ ▲▲ │ ││ h ◀ ─── + ─── ▶ l ││ page │ ││ ▼ ▼▼ - j Ctrl f / Space + j Ctrl f / Space ``` + --- | - | - | -|----------------------|-----------------------| +| -------------------- | --------------------- | | `h`, `j`, `k` ,`l` | Left, Down, Up, Right | | `Ctrl` `b` | Page up | | `Space` / `Ctrl` `f` | Page down | | `g` / `G` | Go to beginning / end | | `Arrows` | Up, Down, Left, Right | + {.shortcuts} - - ### Copy to Clipboard - Command Syntax: + ``` :export.clip format flow ``` ----------------- + +--- + Example: | Description | Command Example | -|--------------------------------|------------------------------------| +| ------------------------------ | ---------------------------------- | | 1. Copy as a curl command | `:export.clip curl @focus` | | 2. Copy as a httpie | `:export.clip httpie @focus` | | 2. Copy as a raw | `:export.clip raw @focus` | | 2. Copy as a raw HTTP request | `:export.clip raw_request @focus` | | 2. Copy as a raw HTTP response | `:export.clip raw_response @focus` | + {.style-list} Export a flow to the system clipboard. - - - ### Save to File Command Syntax: + ``` :export.file format flow path ``` ----------------- + +--- + Example: | Description | Command Example | -|------------------------------|----------------------------------------------------| +| ---------------------------- | -------------------------------------------------- | | 1. Export to /tmp/a.curl | `:export.file curl @focus /tmp/a.curl` | | 2. Export to /tmp/a.httpie | `:export.file httpie @focus /tmp/a.httpie` | | 2. Export to /tmp/a.raw | `:export.file raw @focus /tmp/a.raw` | | 2. Export to /tmp/a.request | `:export.file raw_request @focus /tmp/a.request` | | 2. Export to /tmp/a.response | `:export.file raw_response @focus /tmp/a.response` | + {.style-list} Export a flow to the system clipboard. - - ### Common Keybindings + | - | - | -|---------|------------------| +| ------- | ---------------- | | `q` | Back / Exit | | `z` | Clear flow list | | `:` | Command prompt | @@ -111,13 +114,13 @@ Export a flow to the system clipboard. | `r` | Replay this flow | | `Tab` | Next | | `Enter` | Select | + {.shortcuts} - - ### Global Keybindings + | - | - | -|----------------|---------------------------| +| -------------- | ------------------------- | | `-` | Cycle to next layout | | `?` | View help | | `B` | Start an attached browser | @@ -130,52 +133,47 @@ Export a flow to the system clipboard. | `i` | Set intercept | | `Ctrl` `right` | Focus next layout pane | | `Shift` `tab` | Focus next layout pane | + {.shortcuts} - - - - - ### Flow (View) -| - | - | -|------------|------------------------------| -| `A` | Resume all intercepted flows | -| `D` | Duplicate flow | -| `F` | Set focus follow | -| `L` | Load flows from file | -| `M` | Toggle viewing marked flows | -| `S` | Start server replay | -| `U` | Un-set all marks | -| `V` | Revert changes to this flow | -| `X` | Kill this flow | -| `Z` | Purge all flows not showing | -| `a` | Resume this intercepted flow | -| `b` | Save response body to file | -| `d` | Delete flow from view | -| `e` | Export this flow to file | -| `f` | Set view filter | -| `m` | Toggle mark on this flow | -| `n` | Create a new flow | -| `o` | Set flow list order | -| `r` | Replay this flow | -| `v` | Reverse flow list order | -| `w` | Save listed flows to file | -| `|` | Run a script on this flow | -| `Ctrl` `l` | Send cuts to clipboard | + +| - | - | +| --------------- | ---------------------------- | +| `A` | Resume all intercepted flows | +| `D` | Duplicate flow | +| `F` | Set focus follow | +| `L` | Load flows from file | +| `M` | Toggle viewing marked flows | +| `S` | Start server replay | +| `U` | Un-set all marks | +| `V` | Revert changes to this flow | +| `X` | Kill this flow | +| `Z` | Purge all flows not showing | +| `a` | Resume this intercepted flow | +| `b` | Save response body to file | +| `d` | Delete flow from view | +| `e` | Export this flow to file | +| `f` | Set view filter | +| `m` | Toggle mark on this flow | +| `n` | Create a new flow | +| `o` | Set flow list order | +| `r` | Replay this flow | +| `v` | Reverse flow list order | +| `w` | Save listed flows to file | +| \| | Run a script on this flow | +| `Ctrl` `l` | Send cuts to clipboard | {.shortcuts} - - - -Mitmproxy Filter ---------------- +## Mitmproxy Filter ### Filter + | - | - | -|-----|---------------------------------------| +| --- | ------------------------------------- | | `f` | Set view filter _(on flow view page)_ | + {.shortcuts} --- @@ -184,22 +182,19 @@ Mitmproxy Filter The regex are Python-style, it can be specified as quoted strings - - ### Operators | - | - | -|---------|-----------| +| ------- | --------- | --- | | `!` | unary not | | `&` | and | -| `|` | or | +| ` | ` | or | | `(...)` | grouping | - ### Expressions {.row-span-2} | - | - | -|----------------|------------------------------------------------------------| +| -------------- | ---------------------------------------------------------- | | `~a` | Match asset in response: CSS, Javascript, Flash, images. | | `~b` `regex` | Body | | `~bq` `regex` | Request body | @@ -225,9 +220,11 @@ The regex are Python-style, it can be specified as quoted strings | `~websocket` | Match WebSocket flows (and HTTP-WebSocket handshake flows) | ### Flow selectors + Expressions + | - | - | -|-------------|----------------------------| +| ----------- | -------------------------- | | `@all ` | All flows | | `@focus ` | The currently focused flow | | `@shown ` | All flows currently shown | @@ -237,9 +234,8 @@ Expressions mitmproxy has a set of convenient flow selectors that operate on the current view - - ### Examples + URL containing "google.com" ``` @@ -247,28 +243,24 @@ google\.com ``` Requests whose body contains the string "test" + ``` ~q ~b test ``` Anything but requests with a text/html content type: + ``` !(~q & ~t "text/html") ``` Replace entire GET string in a request (quotes required to make it work): + ``` ":~q ~m GET:.*:/replacement.html" ``` - - - - - -Mitmproxy Scripts {.cols-2} -------- - +## Mitmproxy Scripts {.cols-2} ### Custom response @@ -284,10 +276,9 @@ def request(flow: http.HTTPFlow) -> None: {"Content-Type": "text/html"} # (optional) headers ) ``` + Send a reply from the proxy without sending any data to the remote server - - ### Add header ```python @@ -304,9 +295,10 @@ addons = [ AddHeader() ] ``` + Add an HTTP header to each response -Also see -------- +## Also see + - [mitmproxy addons](https://github.com/mitmproxy/mitmproxy/tree/master/examples/addons) _(github.com)_ - [mitmproxy docs](https://docs.mitmproxy.org/) _(mitmproxy.org)_