utlsproxy

command module
v0.0.0-...-5768e86 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 24, 2024 License: GPL-3.0 Imports: 12 Imported by: 0

README

logo

uTLS Proxy

MITM Proxy with TLS mimicry


Features

  • Man-in-the-middle TLS connections
  • Mimic TLS records from the client
  • Directly proxy all application data below TLS (for example, http2 frames will be exactly what the client sends)
  • SSL/TLS Keylog support (inspect TLS contents in wireshark)
  • Certificate server at utlsproxy.ws (certificates are created locally)

Installation

$ go install github.com/saucesteals/utlsproxy

Usage

$ utlsproxy
  -addr string
        Address to bind to (default ":8080")
  -keylog string
        TLS key log file
  -http1
        Force HTTP/1.1 between client and proxy

Why?

All (to my knowledge) MITM proxies replay requests to servers with stdlib transports, essentially letting the server fingerprint it. The goal of utlsproxy is to allow you to inspect TLS application data while mimicing the original client. The proxy will sniff the client's clienthello message and use it as its own when handshaking with the server.

Curious how? Most of the work is at saucesteals/goproxy (credits to elazarl/goproxy for the base proxy implementation)

mTLS

Like every other MITM, this will not work with mTLS. Find the client's certificate and private key, then add it to the tls.Config (Rarely will you need this, so this is only possible by cloning and adding it yourself)

Contributing

Contributions are welcome!

License

Distributed under the GNU GPL v3.0 License. See LICENSE for more information.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL