@rafaelgss tech blog

HTTP Proxy Tunneling

How much do you trust your HTTP Proxy Client?

Most developers have at least heard about HTTP Proxy and some of them use it on a daily basis. They are excellent ways to intercept and debug HTTP requests made from your local environment. I strongly suggest checking them out.

There are a large number of HTTP Proxy available in the market/community. My personal preference are:

Nevertheless, most developers don’t know precisely how HTTP Proxy works under the hood. By the way, is totally acceptable not to know that. But, let’s assume you attend an interview and the interviewer for some weird reason asks you to implement a simple HTTP proxy client (forward proxy), would you be able to do it?

The vast majority would end up with an implementation pretty similar to this:

const http = require('http')

  hostname: 'localhost', // proxy url
  port: 8000, // proxy port
  path: 'https://example.com/', // requested server
  headers: {
    host: 'example.com'
}, (res) => {
  console.log(res.statusCode) // 200

Well… This likely will work. But, this is totally unsafe and in this blog post, I’ll show you why.

This is a longer explanation of a security advisory that undici received in version v5.5.0. Further information at GHSA-pgw7-wx7w-2w33. It was fixed in [email protected].

Firstly, what is Proxy, and why would someone use it?

A Proxy is a gateway (intermediary) between the client (you) and the requested server. If you are using an HTTP Proxy, all the HTTP Traffic flows through the proxy to the requested endpoint.

Proxy image example

Usually, a proxy provides much more than forwarding HTTP requests. If you care about your privacy and security diving into the internet, a proxy can suit you. It can also speed up your network requests if the latency between your ISP(Internet Service Provider) and the requested server is a problem.

Proxy example hops latency

The proxy can be used to intercept, inspect, modify and replay web traffic such as HTTP/1, HTTP/2, Web Sockets, or any other SSL/TLS-protected protocols and this is certainly one of my favorite usage of it and this is the one we’ll focus in the post. If you haven’t tested it I strongly recommend it, you won’t regret it.

Proxy example intercepting requests

HTTP Proxy client challenges

At the beginning of this article, a snippet was shared with the following strong statement:

“Well… This likely will work. But, this is totally unsafe and in this blog post, I’ll show you why.”

It’s time to explain it. There are two possible ways to use a proxy server:

  1. The HTTP client makes a request with an absolute URL (_GET https://example.com/) _to the proxy server, and expects the proxy connects to the upstream and perform the request.
  2. The HTTP client sends an HTTP CONNECT to create a tunnel to the upstream and then makes a request within that tunnel.

The first one is basically what the snippet does, and when you are using an HTTPS Proxy it would expose all the traffic to your proxy. In case you trust (with all of your heart) the proxy server, it is fine.

Proxy HTTPS example

Nevertheless, when the proxy server is available in a non-TLS connection, it means that all of your data is exposed in the network. It’s not uncommon to see local proxies using HTTP without a TLS connection. Actually, a vast piece of developers that uses an HTTP Proxy to debug/intercept requests rely on an HTTP Local Proxy.

Proxy MiTM attack example

As described by the above image, even though the requested endpoint uses a TLS connection, the request is sent to the Proxy using HTTP, which means that anybody in your local network can intercept and read packages. In case you are using Public Wi-Fi… I’d say you are at serious risk.

For scientific reasons, you can use Wireshark to sniff the local network while performing an HTTPS Request using the ProxyAgent from [email protected]:

// undici-mitm.mjs
import { ProxyAgent } from 'undici'
const proxyUrl = 'http://localhost:8000' // default address for HTTPToolkit
const dispatcher = new ProxyAgent({ uri: proxyUrl })

await fetch("https://example.com", {
  method: 'POST',
  body: JSON.stringify({
    user: 'rafaelgss',
    password: 'mysecurepassword'

Run it with:

$ node undici-mitm.mjs

It will work like a charm, you’ll be able to intercept and visualize the request in the HTTPToolkit if you want

HTTPToolkit Example request

All properly correct, right? Wrong!

Using the following query on Wireshark will show that even requesting a TLS endpoint, you are leaking everything in your local network.

http.host contains example.com

Wireshark leak example

For this reason, HTTP Tunneling is a great approach to use when building an HTTP Proxy Client.

HTTP Proxy Tunneling

HTTP Tunneling is used to create a tunnel between the origin and the destination through an intermediary (proxy). This mechanism asks the HTTP Proxy Server to forward the TCP connection to the destination using the CONNECT HTTP Method. Once the connection has been established, the proxy server pipe the TCP stream to the origin, which means, any data sent to the proxy using the established connection will be propagated to the destination. This mechanism allows the client behind an HTTP Proxy (no-TLS) to perform requests using TLS.

Proxy connection example

Proxy HTTP example tunnel

Ensure to use a good HTTP Client library

Normally, a developer would not write his own HTTP Client, instead, he’ll search for a library of his choice. However, one has to ensure to a safe HTTP Client library. There are several ways to validate the approach used by the library:

  1. Reading the docs whether is anything explicitly written.
  2. Reading the source code.
  3. Asking the maintainers and eventually raising a PR to improve the documentation.

As said previously, undici (the Node.js HTTP Client) upgraded their ProxyAgent to use HTTP Tunneling. If the library your choice is not using a safe approach, please, consider changing it.


Matteo Collina, Simone Busoli, and Paolo Insogna for reviewing it.