Skip to content

Commit

Permalink
Re-add private network
Browse files Browse the repository at this point in the history
  • Loading branch information
KeiranY committed Apr 27, 2019
1 parent 4f7b240 commit fe4311b
Show file tree
Hide file tree
Showing 3 changed files with 40 additions and 7 deletions.
40 changes: 35 additions & 5 deletions README.rst
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
DVNI
================================
====

Damn Vulnerable Network Infrastructure (DVNI) is a project based on Containernet that creates vulnerable Software Defined Networks (SDN) to allow users to practice Ethical Hacking techniques against Layer 2/3 network services.

Getting Started
=================
===============
Requirements
-------------------
---------------

`Vagrant <https://www.vagrantup.com/downloads.html>`_ - The project uses a virtual machine (VM) which is downloaded and configured using vagrant.

Expand All @@ -17,16 +17,46 @@ Requirements
*VNC Viewer OR a Web Browser* - Most tasks supply a Kali machine that is connected to through either VNC or NoVNC in a web browser.

Installation
-------------------
------------

Once you have installed the required utilitiles start the project with Vagrant (First time setup may take some time):
Once you have installed the required utilitiles simply start the project with Vagrant (First time setup may take some time):

``vagrant up``

After this has completed you are free to try out the scenarios!

Usage
-----

You can connect to the project either using `VirtualBox` to view the VM or through SSH.

Connect to the device through SSH with the credentials `student`:`student` or `teacher`:`teacher` and follow the guidance from there:

``ssh student@10.10.0.1``

Development
-----------

To access the VM without being connected directly to the project, connect with Vagrant:

``vagrant ssh``

To run DVNI as a developer run `start.py` from the project root.

``python /vagrant/start.py``

You can also run scenarios and containers directly, although these options are available through `start.py`:

``python /vagrant/scenarios/HostScanning.py``
``python /vagrant/containers/``

Documentation
-------------
Documentation is available online provided by `GitHub.io <https://kcyoung1997.github.io/DVNI-docs/>`_.

The documentation is created with `Sphinx <http://www.sphinx-doc.org/>`_ and `ReadTheDocs <http://www.sphinx-doc.org/>`_.
To generate the documentation run the makefile in the `docs` folder:

``make html``


4 changes: 2 additions & 2 deletions Vagrantfile
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@ Vagrant.configure("2") do |config|
config.vm.base_mac = "029CD253C1D1"

config.ssh.username = 'root'
config.vm.network "forwarded_port", guest: 22, host: 22222, host_ip: "127.0.0.1", id: 'ssh'
config.vm.network "forwarded_port", guest: 22, host: 2222, host_ip: "127.0.0.1", id: 'ssh'

# Add a host only network
#config.vm.network "private_network", ip: "10.10.0.2"
config.vm.network "private_network", ip: "10.10.0.2"

# Run config
config.vm.provision "shell", path: "config.sh"
Expand Down
3 changes: 3 additions & 0 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
.. include:: ../../README.rst

Code Documentation
==================

.. toctree::
:maxdepth: 4
:titlesonly:
Expand Down

0 comments on commit fe4311b

Please sign in to comment.