No description
Find a file
2022-03-02 14:49:24 +01:00
.github Add lint Github Action 2022-02-01 18:14:14 +01:00
admin Add "Copy to Sender" button in reqlog table 2022-03-02 08:14:44 +01:00
cmd/hetty Misc lint fixes 2022-02-28 16:21:01 +01:00
docs Update Dockerfile 2022-01-26 11:35:47 +01:00
pkg Misc lint fixes 2022-02-28 16:21:01 +01:00
.dockerignore Use embed instead of rice 2021-04-26 09:24:45 +02:00
.gitignore Tidy up admin structure 2022-02-23 15:20:23 +01:00
.golangci.yml Misc lint fixes 2022-02-28 16:21:01 +01:00
.goreleaser.yml Add Homebrew tap to GoReleaser config 2022-03-02 14:49:24 +01:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2020-10-04 12:33:53 +02:00
CONTRIBUTING.md Add contributing guidelines 2020-10-04 13:21:43 +02:00
Dockerfile Update Dockerfile 2022-01-26 11:35:47 +01:00
go.mod Add certificate management subcommands 2022-02-28 15:31:16 +01:00
go.sum Add certificate management subcommands 2022-02-28 15:31:16 +01:00
gqlgen.yml Add Sender module 2022-02-22 14:10:39 +01:00
LICENSE Bump copyright year 2022-01-01 16:15:03 +01:00
Makefile Fix default make target 2022-02-01 18:12:44 +01:00
README.md Fix README 2022-01-31 16:17:19 +01:00
tools.go Replace SQLite with BadgerDB 2022-01-21 11:45:54 +01:00

Latest GitHub release Build Status GitHub download count GitHub Documentation

Hetty is an HTTP toolkit for security research. It aims to become an open source alternative to commercial software like Burp Suite Pro, with powerful features tailored to the needs of the infosec and bug bounty community.

Features

  • Man-in-the-middle (MITM) HTTP/1.1 proxy with logs
  • Project based database storage (BadgerDB)
  • Scope support
  • Headless management API using GraphQL
  • Embedded web interface (Next.js)

Hetty is in early development. Additional features are planned for a v1.0 release. Please see the backlog for details.

Documentation

📖 Read the docs.

Installation

Hetty compiles to a self-contained binary, with an embedded BadgerDB database and web based admin interface.

👉 Downloads for Linux, macOS and Windows are available on the releases page.

Build from source

Prerequisites

When building from source, the static resources for the admin interface (Next.js) need to be generated via Yarn. The generated files will be embedded (using the embed package) when you use the build Makefile target.

Clone the repository and use the build make target to create a binary:

$ git clone git@github.com:dstotijn/hetty.git
$ cd hetty
$ make build

Docker

A Docker image is available on Docker Hub: dstotijn/hetty. For persistent storage of CA certificates and projects database, mount a volume:

$ mkdir -p $HOME/.hetty
$ docker run -v $HOME/.hetty:/root/.hetty -p 8080:8080 dstotijn/hetty

Usage

When Hetty is run, by default it listens on :8080 and is accessible via http://localhost:8080. Depending on incoming HTTP requests, it either acts as a MITM proxy, or it serves the API and web interface.

By default, the projects database files and CA certificates are stored in a .hetty directory under the user's home directory ($HOME on Linux/macOS, %USERPROFILE% on Windows).

To start, ensure hetty (downloaded from a release, or manually built) is in your $PATH and run:

$ hetty

An overview of configuration flags:

$ hetty -h
Usage of ./hetty:
  -addr string
        TCP address to listen on, in the form "host:port" (default ":8080")
  -adminPath string
        File path to admin build
  -cert string
        CA certificate filepath. Creates a new CA certificate if file doesn't exist (default "~/.hetty/hetty_cert.pem")
  -key string
        CA private key filepath. Creates a new CA private key if file doesn't exist (default "~/.hetty/hetty_key.pem")
  -db string
        Database directory path (default "~/.hetty/db")

You should see:

2022/01/26 10:34:24 [INFO] Hetty (v0.3.2) is running on :8080 ...

Then, visit http://localhost:8080 to get started.

Detailed documentation is under development and will be available soon.

Certificate Setup and Installation

In order for Hetty to proxy requests going to HTTPS endpoints, a root CA certificate for Hetty will need to be set up. Furthermore, the CA certificate may need to be installed to the host for them to be trusted by your browser. The following steps will cover how you can generate your certificate, provide them to hetty, and how you can install them in your local CA store.

⚠️ This process was done on a Linux machine but should provide guidance on Windows and macOS as well.

Generating CA certificates

You can generate a CA keypair two different ways. The first is bundled directly with Hetty, and simplifies the process immensely. The alternative is using OpenSSL to generate them, which provides more control over expiration time and cryptography used, but requires you install the OpenSSL tooling. The first is suggested for any beginners trying to get started.

Generating CA certificates with hetty

Hetty will generate the default key and certificate on its own if none are supplied or found in ~/.hetty/ when first running the CLI. To generate a default key and certificate with hetty, simply run the command with no arguments

hetty

You should now have a key and certificate located at ~/.hetty/hetty_key.pem and ~/.hetty/hetty_cert.pem respectively.

Generating CA certificates with OpenSSL

You can start off by generating a new key and CA certificate which will both expire after a month.

mkdir ~/.hetty
openssl req -newkey rsa:2048 -new -nodes -x509 -days 31 -keyout ~/.hetty/hetty_key.pem -out ~/.hetty/hetty_cert.pem

The default location which hetty will check for the key and CA certificate is under ~/.hetty/, at hetty_key.pem and hetty_cert.pem respectively. You can move them here and hetty will detect them automatically. Otherwise, you can specify the location of these as arguments to hetty.

hetty -key key.pem -cert cert.pem

Trusting the CA certificate

In order for your browser to allow traffic to the local Hetty proxy, you may need to install these certificates to your local CA store.

On Ubuntu, you can update your local CA store with the certificate by running the following commands:

sudo cp ~/.hetty/hetty_cert.pem /usr/local/share/ca-certificates/hetty.crt
sudo update-ca-certificates

On Windows, you would add your certificate by using the Certificate Manager. You can launch that by running the command:

certmgr.msc

On macOS, you can add your certificate by using the Keychain Access program. This can be found under Application/Utilities/Keychain Access.app. After opening this, drag the certificate into the app. Next, open the certificate in the app, enter the Trust section, and under When using this certificate select Always Trust.

Note: Various Linux distributions may require other steps or commands for updating their certificate authority. See the documentation relevant to your distribution for more information on how to update the system to trust your self-signed certificate.

Vision and roadmap

  • Fast core/engine, built with Go, with a minimal memory footprint.
  • Easy to use admin interface, built with Next.js and Material UI.
  • Headless management, via GraphQL API.
  • Extensibility is top of mind. All modules are written as Go packages, to be used by Hetty, but also as libraries by other software.
  • Pluggable architecture for MITM proxy, projects, scope. It should be possible. to build a plugin system in the (near) future.
  • Based on feedback and real-world usage of pentesters and bug bounty hunters.
  • Aim for a relatively small core feature set that the majority of security researchers need.

Support

Use issues for bug reports and feature requests, and discussions for questions and troubleshooting.

Community

💬 Join the Hetty Discord server.

Contributing

Want to contribute? Great! Please check the Contribution Guidelines for details.

Acknowledgements

Sponsors

Sponsored by Tines

License

MIT License


© 2021 David Stotijn — Twitter, Email