mitm

README

mitm

A golang mitm library

Request

To use this library, you should have a CA (cert.pem and key.pem).

If you don't have CA files, you can use openssl to generate a custom one like below.

# generate a local RSA CA
openssl req -x509 -nodes -days 365 -newkey rsa:4096 -keyout ca-key.pem -out ca-cert.pem

Usage

package main

import (
    "github.com/xslook/mitm"
)

func mitmHandler(w http.ResponseWriter, r *http.Request) {
    // TODO: handle request/response here
}

func main() {
    certFile := "ca-cert.pem"
    keyFile := "ca-key.pem"
    ca, err := tls.LoadX509KeyPair(certFile, keyFile)
    if err != nil {
        panic(err)
    }
    opts := mitm.Options{
        CA:     ca,
        Handle: mitmHandler,
    }
    proxy, err := mitm.New(opts)
    if err != nil {
        panic(err)
    }
    http.ListenAndServe(":8080", proxy)
}

LICENSE

This project is licensed under the terms of the MIT license.

Documentation

Index

• func BypassHandler(w http.ResponseWriter, r *http.Request)
• type Option
  • func CA(ca *tls.Certificate) Option
  • func Default(h http.HandlerFunc) Option
  • func Dir(dir string) Option
• type Proxy
  • func New(rules Rules, options ...Option) (*Proxy, error)
  • func (p Proxy) ServeHTTP(w http.ResponseWriter, r *http.Request)
• type Rules

Functions

func BypassHandler

func BypassHandler(w http.ResponseWriter, r *http.Request)

BypassHandler pipe request and response, like a normal transparent proxy

Types

type Option

type Option func(*Proxy) error

Option to custom proxy

func CA

func CA(ca *tls.Certificate) Option

CA option custom CA certificates to use as root CA, it will be used to sign sites' mitm certificates

func Default

func Default(h http.HandlerFunc) Option

func Dir

func Dir(dir string) Option

Dir option custom directory to store certificates

type Proxy

type Proxy struct {
	// contains filtered or unexported fields
}

Proxy mitm requests

func New

func New(rules Rules, options ...Option) (*Proxy, error)

New a mitm proxy

func (Proxy) ServeHTTP

func (p Proxy) ServeHTTP(w http.ResponseWriter, r *http.Request)

type Rules

type Rules map[string]http.HandlerFunc

Rules for mitm proxy