Skip to content

Latest commit

 

History

History
36 lines (25 loc) · 1020 Bytes

README.md

File metadata and controls

36 lines (25 loc) · 1020 Bytes

MIRACL Proxy

Proxy implementation that allows modification of the traffic from and to the samples for testing purposes.

Modes

The proxy has two modes - one that simply forwards the traffic and one which allows us to modify the requests and responses coming and going through the proxy, using Man-In-The-Middle (MITM).

MITM

A POST request to the /session endpoint starts a MITM session. The body of the request should contain JSON document with modifyUrl property. This property is the URL where the proxy will redirect all traffic until the session is stopped. A DELETE request to the /session endpoint stops the session.

Usage

The proxy is written in Go, so it can be run either as a Go service:

cd ./proxy
go run .

or as a Docker container:

docker build -t proxy .
docker run --publish 8080:8080 proxy

Then you need to pass the PROXY_HOST and PROXY_PORT environment variables to your sample as described here.