RPKI updates 09/30:

To deploy RPKI:

• I modifed the /exmaples/B00-mini-internet/mini-internet.py
• In this example only the StubASes implement RPKI.

Notes:

• The RPKI validator should be installed and the RTR port listening on port 3323.
• You can check the status of the rpki using this command in birdc: 'show protocol all rpki1'
• You can check /var/log/bird.log for debugging.
• This modification implements the best case scenario, where all ASs has a rpki validator implemented. You can reconfigure the router /etc/bird/bird.conf to route without using RPKI.

The changes done on the .py files are:

• The connection to the real internet - /seedemu/core/Node.py line 1035 and 1044.
• The validator installation and RTR server setup - /seedemu/compiler/Docker.py line 25-26,and 870-893.
• Bird configuration - /seedemu/layers/Ebgp.py line 41-82, ,'145-148', and '169-251'.
• Changed on line in /seedemu/utilities/Makers.py line 102, to implent the rpki configuration on the routers that has rpki host.

To test RPKI - you can use the following to hijack a prefix.

protocol static hijacks {
    ipv4 {
        table t_bgp;
    };
    route 74.80.186.0/25 blackhole   { bgp_large_community.add(LOCAL_COMM); };
    route 74.80.186.128/25 blackhole { bgp_large_community.add(LOCAL_COMM); };
}

I usually add "# BA" when adding or changing any code for referance. Let me know if something does not make sense (becuase there is a lot =D). My aim is to make less changes to the main files and make one python file to deploy RPKI, but need to figure out the space issue.

---

---

Internet Emulator

The objective of the SEED-Emulator project is to help create emulators of the Internet. These emulators are for educational uses, and they can be used as the platform for designing hands-on lab exercises for various subjects, including cybersecurity, networking, etc.

The project provides essential elements of the Internet (as Python classes), including Internet exchanges, autonomous systems, BGP routers, DNS infrastructure, a variety of services. Users can use these elements as the building blocks to build their emulation programmatically. The output of the program is a set of docker container folders/files. When these containers are built and started, they form a small-size Internet. New building blocks are being added, including Blockchain, Botnet, and many other useful elements of the Internet.

Table of Contents

• Getting Started
• Documentation
• Contributing
• License

Getting Started

To get started with the emulator, install docker, docker-compose, and python3. Then, take a look at the examples/ folder for examples. Detailed explanation is provided in the README file, as well as in the comments of the code. To run an example:

1. Pick an example, say A00-simple-peering.
2. Add seedemu to PYTHONPATH. This can be done by running source development.env under the project root directory.
3. Build the emulation. For this example, cd to examples/A00-simple-peering/, and run python3 ./simple-peering.py. The container files will be created inside the output/ folder. For some examples, such as B02-mini-internet-with-dns, they depend on other examples, so you need to run those examples first. This is part of our component design.
4. Build and run the containers. First cd output/, then do docker-compose build && docker-compose up. The emulator will start running. Give it a minute or two (or longer if your emulator is large) to let the routers do their jobs.
5. Optionally, start the seedemu web client. Open a new terminal window, navigate to the project root directory, cd to client/, and run docker-compose build && docker-compose up. Then point your browser to http://127.0.0.1:8080/map.html, and you will see the entire emulator. Use the filter box if you want to see the packet flow.

Documentation

Documentation is in progress inside the docs/ folder.

Contributing

Contributions to SEED-Emulator are always welcome. For contribution guidelines, please see CONTRIBUTING.

License

The software is licensed under the GNU General Public License v3.0 license, with copyright by The SEED-Emulator Developers (see LICENSE).