Skip to main content

A firewall that leverage AMQP workqueue ! Build by iresam for iresam !

Project description


Code Quality Status Build Coverage Build Status Requirements Status Pypi version

A simply logic, configuration based, distributable and reliable extended-firewall.

Saruman is a extended firewall (meaning firewall + dns + dhcp +intruision detection + reverse proxy) build by a former Iresam. It targets I-Resam need’s first but should be enough flexible to be used elsewhere.

It still unstable and yet brings not that much. Try at your own risks.

Most important Urls

And… we’re automatically being tested by Scrutinizer !

Technologies used

  • Saruman does require Python 3, and if possible the newest version (Python3.5 for now)
  • It does require an Celery broker : take RabbitMQ, it is good, fast and reliable.
  • It does only works on a recent linux machine : it requires nftables and iproute2 so a linux 4+ kernel would be a necessity.

Available commands

Saruman gives you three commands to manage the worker and one to run your firewall. Worker’s commands must be run in root since they manage main parts of your system. Firewall’s one doesn’t need this. The commands are:

  • saruman workers enable: start the celery workers on the machine.
  • saruman workers disable: start the celery workers on the machine.
  • saruman workers reload: restart the celery workers on the machine.
  • saruman firewall start: start the firewall

AMQP json-rpc api

Still infant


  • Tycho Tatitscheff (Nelen & Schuurmans) is the originator and main author.
  • Zest software for their releases manager and also for inspiration (copy paste of most docs).

Changelog for Saruman

0.3.0 (2016-01-03)

  • big modifications of the documentation structure

0.2.3 (2016-01-03)

  • fixing badges and coverage in testing

0.2.2 (2016-01-03)

  • testing works

0.2.1 (2016-01-03)

  • fixing a lot of nasty issues

0.2.0 (2016-01-03)

  • adding sphinx documentation
  • adding CI coverage
  • fixing nasty unpack in

0.1.2 (2016-01-03)

  • fixing some typo.

0.1.1 (2016-01-03)

  • remove download urls as we use sdist

0.1.0 (2016-01-03)

  • add zest.release to perform check on release an better automation
  • add some yaml config files

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

saruman-0.3.0.tar.gz (18.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page