https://github.com/dhondta/rpl-attacks
RPL attacks framework for simulating WSN with a malicious mote based on Contiki
https://github.com/dhondta/rpl-attacks
attack contiki malicious-motes research-tools rpl rpl-attacks-framework security-tools simulation simulation-campaign wireless-network wsn
Last synced: 8 months ago
JSON representation
RPL attacks framework for simulating WSN with a malicious mote based on Contiki
- Host: GitHub
- URL: https://github.com/dhondta/rpl-attacks
- Owner: dhondta
- License: gpl-3.0
- Created: 2016-05-08T17:04:42.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-05-07T19:59:23.000Z (over 1 year ago)
- Last Synced: 2024-05-07T20:54:38.643Z (over 1 year ago)
- Topics: attack, contiki, malicious-motes, research-tools, rpl, rpl-attacks-framework, security-tools, simulation, simulation-campaign, wireless-network, wsn
- Language: Python
- Homepage:
- Size: 7 MB
- Stars: 72
- Watchers: 10
- Forks: 43
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
RPL Attacks Framework 
Make simulations of a WSN with a malicious mote for attacking the RPL protocol.
[](https://rpl-attacks.readthedocs.io/en/latest/?badge=latest)
[](https://snyk.io/test/github/dhondta/rpl-attacks?targetFile=requirements.txt)
[](https://zenodo.org/badge/latestdoi/22624/dhondta/rpl-attacks)
[](https://www.blackhat.com/eu-18/arsenal/schedule/index.html#rpl-attacks-framework-attacking-rpl-in-wsns-12671)
[](https://app.vagrantup.com/dhondta/boxes/rpl-attacks)
[](https://github.com/dhondta/rpl-attacks/blob/master/LICENSE)
This project aims to provide a simple and convenient interface relying on [Contiki OS](https://github.com/contiki-os/contiki) to generate [Cooja simulations](https://anrg.usc.edu/contiki/index.php/Cooja_Simulator) and deploy malicious motes for a [Wireless Sensor Network (WSN)](https://en.wikipedia.org/wiki/Wireless_sensor_network) that uses [Routing Protocol for Low-power and lossy devices (RPL)](https://www.ietf.org/proceedings/94/slides/slides-94-rtgarea-2.pdf) ([RFC 6550](https://tools.ietf.org/html/rfc6550)) as its network layer.
With this framework, it is possible to easily define campaign of simulations (in JSON format) either redefining RPL configuration constants, modifying single lines from the [ContikiRPL library](https://github.com/contiki-os/contiki/tree/master/core/net/rpl) or using an own external RPL library. Moreover, experiments in a campaign can be generated either based on a same or a randomized topology for each simulation.
See the [Wiki](https://github.com/dhondta/rpl-attacks/wiki) for additional documentation.
### A few test cases made with the framework:
#### Test case 1: flooding attack
The malicious mote has 3, 7, 10 in its range | Power tracking without the malicious mote | Power tracking with the malicious mote
:-------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------:
 |  | 
#### Test case 2: versioning attack
Legitimate DODAG | Versioning attack in action (global repair)
:-------------------------------------------------------:|:-----------------------------------------------------:
 | 
Power tracking without the malicious mote | Power tracking with the malicious mote
:-----------------------------------------------------------------:|:---------------------------------------------------------------:
 | 
#### Test case 3a: blackhole attack
Legitimate DODAG | Blackhole attack in action
:-------------------------------------------------------------:|:-----------------------------------------------------------:
 | 
#### Test case 3b: blackhole attack
Legitimate DODAG | Blackhole attack in action
:-------------------------------------------------------------:|:-----------------------------------------------------------:
 | 
## :cd: Installation
1. Clone this repository
```
$ git clone https://github.com/dhondta/rpl-attacks.git
```
> **Behind a proxy ?**
>
> Setting: `git config --global http.proxy http://[user]:[pwd]@[host]:[port]`
>
> Unsetting: `git config --global --unset http.proxy`
>
> Getting: `git config --global --get http.proxy`
2. Create the VM
```
$ vagrant login
[...]
$ vagrant up
```
> **Important notes**
>
> The downloads of the Vagrant box may take a while, please be patient...
>
> Also, after the creation of the VM, Vagrant may complain that the *SSH connection was unexpectedly closed by the remote end*. In practice, this does not affect the creation and operation of the box.
> **Behind a proxy ?**
>
> Install the plugin: `vagrant plugin install vagrant-proxyconf`
>
> Configure Vagrant: Uncomment the lines starting with `config.proxy` in the `Vagrantfile`
> **Troubleshooting**:
>
> - Ensure the latest version of Vagrant is installed
> - If using `virtualbox` provider, ensure Oracle Extension Pack is installed (see [Oracle website](https://www.google.be/#q=virtualbox+oracle+extension+pack+install))
> **Using Instant Contiki or another distribution**:
>
> The full manual installation procedure is available [here](https://rpl-attacks.readthedocs.io/en/latest/install/#manual-installation) and mentions [InstantContiki](https://sourceforge.net/projects/contiki/files/Instant%20Contiki/) but it is advised to use the [Vagrant box](https://app.vagrantup.com/dhondta/boxes/rpl-attacks) as it was fully tested.
## :sunglasses: Demonstration
This will make 3 complete examples of attacks : hello flood, version number and blackhole.
Open the console like before and type:
```
user@instant-contiki:rpl-attacks>> demo
```
Or simply launch the `demo` command with Fabric:
```
./rpl-attacks$ fab demo
```
## :fast_forward: Quick Start
1. Open the console (you should see something like in the following screenshot)
```
./rpl-attacks$ python main.py
```
or
```
./rpl-attacks$ fab console
```
2. Create a campaign of simulations
```
user@instant-contiki:rpl-attacks>> prepare sample-attacks
```
3. Go to your experiments folder (default: `~/Experiments`) and edit your new `sample-attacks.json` to suit your needs
See [*How to create a campaign of simulations ?*](https://github.com/dhondta/rpl-attacks/blob/master/doc/campaigns.md) for more information.
4. Make the simulations
```
user@instant-contiki:rpl-attacks>> make_all sample-attacks
```
5. Run the simulations (multi-processed)
```
user@instant-contiki:rpl-attacks>> run_all sample-attacks
```
**Hint** : You can type ``status`` during ``make_all`` and ``run_all`` processing for getting the status of pending tasks.
6. Once tasks are in status ``SUCCESS`` in the status tables (visible by typing ``status``), just go to the experiment's ``results`` folders to get pictures and logs of the simulations. The related paths are the followings :
``[EXPERIMENTS_FOLDER]/[experiment_name]/without-malicious/results/``
``[EXPERIMENTS_FOLDER]/[experiment_name]/with-malicious/results/``
## :grimacing: Issues management
In case of bug, there should be a **crash report generated in the folder of the experiment** that the framework was processing. By convention, this is named **`crash-report-[...].txt`**. Please copy its content (without the title) in a [new Issue](https://github.com/dhondta/rpl-attacks/issues/new).
For contributions or suggestions, please [open an Issue](https://github.com/dhondta/rpl-attacks/issues/new) and clearly explain, using an example or a use case if appropriate.
If you want to build new RPL attacks, please refer to the [*How to make new building blocks ?*](https://github.com/dhondta/rpl-attacks/blob/master/doc/building-blocks.md) section. In this case, please submit your new attack through a Pull Request.
## :clap: Supporters
[](https://github.com/dhondta/rpl-attacks/stargazers)
[](https://github.com/dhondta/rpl-attacks/network/members)
