/SiegeBreaker

A new SDN based Decoy Routing System which increases deployability and cares about privacy of non-Decoy Routing users.

Primary LanguageCCreative Commons Attribution Share Alike 4.0 InternationalCC-BY-SA-4.0

This repository contains code corresponding to SiegeBreaker, which, consists of these major components:

  1. Client, who wishes to use Decoy Routing and reach a censored website.
  2. Overt-destination, a website, which censor thinks client wants to visit.
  3. Covert-destination, a website, which client really wants to visit.
  4. Proxy, a machine, who proxies client's traffic and fetches covert-destination for it.
  5. SDN Controller, which installs relevant redirection rules on SDN switches.

Building SiegeBreaker

These steps are for Ubuntu 18.04 and derivatives.

The Extremely Easy way

Following docker image has already dependencies installed. Thus we only need to build code.

  1. docker pull himanshusagar/ubuntu_siegebreaker
  2. cd /home/user/
  3. git clone https://github.com/himanshusagar/SiegeBreakerV2
  4. cd SiegeBreakerV2/
  5. chmod +x build_code.sh
  6. ./build_code.sh

The Easy way

Clone a fresh copy of code. Install Dependencies and Build Code.

  1. git clone https://github.com/himanshusagar/SiegeBreakerV2
  2. cd SiegeBreakerV2/
  3. chmod +x build_dep.sh && chmod +x build_code.sh
  4. ./build_dep.sh && ./build_code.sh

The Not-so-easy way

Install all dependencies and code one by one.

Install Generic Dependencies
  1. sudo apt update && sudo apt install gcc make python-minimal libssl-dev git python-pip
Install Seccure
  1. sudo apt install libgmp-dev build-essential python-dev python-pip libmpfr-dev libmpc-dev
  2. pip install seccure
Install Ryu
  1. pip install ryu
Install libpcap
  1. sudo apt install libpcap-dev
Build Signalling Mechanism

There are two signaling mechanisms in place - "smtplib/imap" and webmail. "smtplib/imap" is written in python for sending emails, when invoked by client code. Any of them can be used with client's c code.

Install webmail dependencies
  1. Install Chrome
  2. Install ChromeDriver
  3. Test whether chromedriver works by typing $ chromedriver in terminal.
  4. pip install scapy selenium
Install "smtplib/imap" dependencies
  1. pip install scapy easyimap

Build "C" Code

Build Client
  1. cd main
  2. cd ./client/c
  3. make
  4. cd ../../
Build proxy
  1. cd ./proxy/
  2. make center
  3. make single_conn
  4. cd ../

Running SiegeBreaker

git clone https://github.com/himanshusagar/SiegeBreakerV2

As a Client

  1. cd <repo_path>/main/client/c
  2. sudo ./client.o OD_IP 443 URL TIMEOUT
  3. Example Usage : sudo ./client.o https://allowed_site.com 443 https://censored_site/100M 40
  4. By default, webmail singalling mechanism is used. This can be changed to "smtp/imap" based signaling in client.c by changing 'client_send.py' to 'smtp_client_send.py'

As a Proxy

  1. cd <repo_path>/main/proxy/
  2. sudo ./center.o

As a Controller

  1. cd <repo_path>/main/controller/
  2. ryu-manager controller_HP3500yl.py
  3. Depending upon which signalling mechanism used in client setup, run corresponding email receiver in controller system.

Acknowledgements:

  1. base64.h used from https://github.com/superwills/NibbleAndAHalf