-[![Documentation Status](https://readthedocs.org/projects/flowspy/badge/?version=latest)](https://readthedocs.org/projects/flowspy/?badge=latest)
+Firewall on Demand
+******************
-#Firewall on Demand#
-##Description##
+Description
+===========
-Firewall on Demand applies via NETCONF, flow rules to a network
+Firewall on Demand applies, via Netconf, flow rules to a network
device. These rules are then propagated via e-bgp to peering routers.
Each user is authenticated against shibboleth. Authorization is
performed via a combination of a Shibboleth attribute and the peer
network address range that the user originates from. FoD is meant to
operate over this architecture:
- +-----------+ +------------+ +------------+
- | FoD | NETCONF | flowspec | ebgp | router |
- | web app +----------> device +--------> |
- +-----------+ +------+-----+ +------------+
- | ebgp
- |
- +------v-----+
- | router |
- | |
- +------------+
-
+ +-----------+ +------------+ +------------+
+ | FoD | NETCONF | flowspec | ebgp | router |
+ | web app +----------> device +--------> |
+ +-----------+ +------+-----+ +------------+
+ | ebgp
+ |
+ +------v-----+
+ | router |
+ | |
+ +------------+
NETCONF is chosen as the mgmt protocol to apply rules to a single
flowspec capable device. Rules are then propagated via igbp to all
(via NETCONF always) to a router and then ibgp would do the rest. In
GRNET's case the flowspec capable device is an EX4200.
-**Attention**: Make sure your FoD server has ssh access to your flowspec device.
+Attention: Make sure your FoD server has ssh access to your flowspec device.
-##Installation Considerations##
+Installation Considerations
+===========================
You can find the installation instructions for Debian Wheezy (64)
-with Django 1.4.x at [Flowspy documentation](http://flowspy.readthedocs.org).
-If upgrading from a previous version bear in mind the changes introduced in Django 1.4.
+with Django 1.4.x at http://flowspy.readthedocs.org.
+If upgrading from a previous version bear in mind
+the changes introduced in Django 1.4.
-##Contact##
+Contact
+=======
You can find more about FoD or raise your issues at GRNET FoD
-repository: [GRNET repo](https://code.grnet.gr/fod) or [Github repo](https://github.com/leopoul/flowspy).
+repository: https://code.grnet.gr/fod.
+
+You can contact us directly at noc{at}noc[dot]grnet(.)gr
-You can contact us directly at leopoul{at}noc[dot]grnet(.)gr