Awesome

Yves

Yves is a simple HTTP(s) and WebSocket Man-in-The-Middle proxy.

Main Features

• HTTP(s) and WebSocket Man-in-The-Middle proxy;
• Custom HTTP request\response handlers;
• Custom WebSocket request\response handlers;
• Custom CA for TLS connections;
• Support for upstream proxy.

Usage

Start a server

The following snippets of code shows how to start a simple mitm proxy. More usage examples can be found in the examples folder.

package main

import (
        "log"
        "net/http"

        "github.com/rhaidiz/yves"
)

func main() {
        // create a new mitm proxy
        proxy := yves.NewProxy()

        // Listen on local port 8080
        log.Fatal(http.ListenAndServe(":8080", proxy))
}

Request handler

The following example shows how to use request handler to add a custom header to every request:

proxy.HandleRequest = func(id int64, req *http.Request) *http.Response {
	req.Header.Add("custom", "myval")
	log.Printf("session: %v\n", id)
	return nil
}

Response handler

The following example shows how to prevent access to a requests performed toward a specific host.

proxy.HandleRequest = func(id int64, req *http.Request) *http.Response {
	if req.Host == "example.com" {
		return &http.Response{StatusCode: 500}
	}
	return nil

Examples

More usage can be found in the examples folder.