Quickstart tutorial

This is an introduction step by step tutorial on how to set up Modlishka for local testing.

1. Fetch the tool

$ go get -u github.com/drk1wi/Modlishka
$ cd $GOPATH/src/github.com/drk1wi/Modlishka/

2. Configure the 'autocert' plugin

$ openssl genrsa -out MyRootCA.key 2048`
$ openssl req -x509 -new -nodes -key MyRootCA.key -sha256 -days 1024 -out MyRootCA.pem

Edit the 'plugin/autocert.go' file:

• Replace the const CA_CERT variable with the content of the MyRootCA.pem file (copy and paste).

• Replace the const CA_CERT_KEY variable with the content of the MyRootCA.key file (copy and paste).

Install and set the right trust level for the 'MyRootCA' (MyRootCA.pem file) CA in your browsers certificate store:

• Firefox
• Chrome

3. Compile and launch "Modlishka" using one of the example config files

$ make
$ sudo ./dist/proxy  -config templates/google.com_gsuite.json

3. Test the webpage through your browser

Open your browser and paste in the following URL: https://loopback.modlishka.io