Skip to content
This repository has been archived by the owner on Dec 6, 2023. It is now read-only.

Commit

Permalink
Add example for setting up a MiTM on a Linux box
Browse files Browse the repository at this point in the history
Shows the commands to run on a basic setup with a Linux MiTM with two
interfaces. The same instructions expand to more complicated setups like
one of the interfaces being an access point.
  • Loading branch information
chadbrubaker committed Sep 11, 2015
1 parent ab13cfd commit bd6427c
Showing 1 changed file with 31 additions and 1 deletion.
32 changes: 31 additions & 1 deletion docs/getting_started.md
Expand Up @@ -199,14 +199,44 @@ OpenVPN as there is lots of documentation for how to set up an OpenVPN server.
Our main setup has been OpenVPN running on a Google Compute Engine instance. See instructions in
[gce/readme.md](gce/readme.md).


####Testing Android
For testing Android devices we have included our [Android client](/nogotofail/clients/android) ready
to be imported into Eclipse. You will have to build the app and install it on your test device.

For testing you can use the access point nogotofail setups or on devices >=JB you can use
the OpenVPN setup and a third party VPN application to route your traffic.


#####Getting on path on a Linux machine
On a Linux machine with the following example topology:


------------- ---------- ----------
|test device|--------eth1|MiTM box|eth0--------|internet|
------------- ---------- ----------


First enable IP forwarding

$ echo 1 > /proc/sys/net/ipv4/ip_forward

Next set up eth1 with an IP address

$ ifconfig eth1 10.0.0.1

Then set up NAT on the device

$ iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE

Finally run dnsmasq for DNS and DHCP:

$ dnsmasq eth1


Now traffic will be flowing through the MiTM box from the test device to the
Internet.


###Now you’re on path


Expand Down

1 comment on commit bd6427c

@klyubin
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Please sign in to comment.