https://github.com/tychota/saruman

A simply logic, configuration based, distributable and reliable extended-firewall.
https://github.com/tychota/saruman

Last synced: 2 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/tychota/saruman
• Owner: tychota
• License: mit
• Created: 2015-12-24T12:50:02.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2022-01-06T22:22:51.000Z (almost 3 years ago)
• Last Synced: 2024-10-06T12:48:43.386Z (about 1 month ago)
• Language: Python
• Homepage: http://tychota.github.io/saruman
• Size: 169 KB
• Stars: 8
• Watchers: 5
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • Contributing: CONTRIBUTING.rst

Awesome Lists containing this project

README

        
Saruman

=======

.. image:: https://img.shields.io/scrutinizer/g/tychota/saruman.svg?style=flat-square

    :target: https://scrutinizer-ci.com/g/tychota/saruman/

    :alt: Code Quality Status

.. image:: https://img.shields.io/scrutinizer/coverage/g/tychota/saruman.svg?style=flat-square

    :target: https://scrutinizer-ci.com/g/tychota/saruman/

    :alt: Build Coverage

.. image:: https://img.shields.io/scrutinizer/build/g/tychota/saruman.svg?style=flat-square

    :target: https://scrutinizer-ci.com/g/tychota/saruman/

    :alt: Build Status

.. image:: https://img.shields.io/requires/github/tychota/saruman.svg?style=flat-square

     :target: https://requires.io/github/tychota/saruman/requirements/?branch=master

     :alt: Requirements Status

.. image::	https://img.shields.io/pypi/v/saruman.svg?style=flat-square

    :target: https://pypi.python.org/pypi/saruman

    :alt: 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

-------------------

- The full documentation is at `saruman.readthedocs.org `_

- We are `on Pypi `_ so we're only

  an ``pip install saruman`` away from installation on your computer.

- The code is at `github.com/tychota/saruman

  `_.

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