Quickstart tutorial

Quickstart Tutorial

This tutorial shows how to set up Modlishka for local testing.

1. Install Modlishka

git clone https://github.com/drk1wi/Modlishka.git
cd Modlishka
make

Or using go install:

go install github.com/drk1wi/Modlishka@latest

2. Configure the 'autocert' Plugin

Generate a self-signed CA certificate:

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

Edit plugin/autocert.go:

1. Replace the const CA_CERT variable with the content of MyRootCA.pem
2. Replace the const CA_CERT_KEY variable with the content of MyRootCA.key

Rebuild after editing:

make

Install the CA certificate in your browser:

• Firefox
• Chrome

3. Launch Modlishka

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

4. Test

Open your browser and navigate to: https://loopback.modlishka.io

The loopback.modlishka.io domain resolves to 127.0.0.1, making it convenient for local testing.