Skip to content

GEANT/FOD

Folders and files

NameName
Last commit message
Last commit date
Jan 24, 2024
May 2, 2023
Jan 3, 2023
Aug 30, 2024
Oct 18, 2019
Feb 6, 2020
Oct 26, 2023
Apr 19, 2024
Oct 10, 2023
Jul 17, 2024
Jul 17, 2024
Jun 10, 2020
Jun 27, 2023
Jun 4, 2024
Jun 19, 2018
Jul 25, 2019
Mar 29, 2023
Nov 3, 2022
Oct 23, 2024
Oct 6, 2021
Jan 21, 2022
Jul 8, 2024
Oct 21, 2024
Feb 21, 2024
Jul 17, 2024
Feb 21, 2024
May 25, 2015
Jun 29, 2023
Apr 20, 2023
Jun 7, 2024
Apr 20, 2023
Jul 10, 2023
Apr 20, 2023
Jul 7, 2023
Oct 10, 2023
Oct 10, 2023
Oct 10, 2022
Mar 18, 2022
Jul 15, 2021
Mar 29, 2023
Apr 29, 2020
Nov 15, 2011
Jun 7, 2024
Jul 25, 2019
Apr 21, 2015
Dec 21, 2023
Sep 14, 2023
Mar 26, 2024
Nov 20, 2023
Jun 27, 2023
Apr 20, 2023
Oct 23, 2024
Oct 23, 2024
Feb 17, 2022
Jul 10, 2023
Apr 15, 2019
Nov 22, 2021
Oct 23, 2024
Jul 28, 2023
Jul 28, 2023
Jul 28, 2023
May 22, 2023
Feb 18, 2022
Nov 2, 2022
Apr 19, 2023

Repository files navigation

Documentation Status

Firewall on Demand

Description

Firewall on Demand (hereafter FoD) is based on the flowspy project developed by GRNET.

The FOD server applies flow rules - via NETCONF - to a flowspec-capable network device which then propagates the rules via eBGP to other devices in the network.

Users are 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 using the following architecture:

   +-----------+          +------------+        +------------+
   |   FoD     | NETCONF  | flowspec   | ebgp   |   router   |
   | web app   +----------> device     +-------->            |
   +-----------+          +------+-----+        +------------+
                                 | ebgp
                                 |
                          +------v-----+
                          |   router   |
                          |            |
                          +------------+

Currently supported devices

Fod currently supports updating of router(s) via NETCONF (for more information see doc/prerequisites/generic.md) FoD currently does not support updating directly routers via BGP.

Example of inbound firewall rules required on your flowspec device

Name Protocol Port
NETCONF tcp 830
ssh tcp 22

Documentation

Please visit the documentation directory above (doc) to see FoD's documentation.

GRnet's original flowspy documentation is also available online.

Installation Considerations

If you are upgrading from a previous version bear in mind the changes introduced in Django 1.4.

Rest Api

FoD provides a rest api. It uses token as authentication method. For usage instructions & examples check the documentation.

Limitations

A user can belong to more than one Peer without any limitations.

The FoD UI polls the FoD server to dynamically update the dashboard and the

"Live Status" about the Routes they are aware of. In addition, the polling implementation fetches information for every Peer the user is associated with. Thus, if a user belongs to many Peers too many AJAX calls will be sent to the backend - which may result in a non responsive state. It is recommended to keep the peers associated with any user under 5.

Contact

You can contact us directly at fod{at}lists[dot]geant(.)org

Copyright and license

Copyright © 2017-2023 GÈANT GN4-2/GN4-3/GN5-1 Project

Copyright © 2010-2017 Greek Research and Technology Network (GRNET S.A.)

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.