procustodibus-broker 1.1.1

Description:

procustodibusbroker 1.1.1

Pro Custodibus Broker
Pro Custodibus is a service that makes WireGuard networks easy to deploy and manage.
To integrate Pro Custodibus with your own SIEM or other log tools, you can run the Pro Custodibus broker on one of your own internal hosts, and the broker will pull alerts and other events from Pro Custodibus and push them to your own security management systems.
Installing
Requires python 3.8 or newer and libsodium. Installer script can install requirements, plus the broker itself, on most linuxes. Install from source like the following:
./install.sh --install

Or run it like the following to see more options:
./install.sh --help

See the Installer Documentation for full details.
Development
Set up dev env

Create a virtualenv with pyenv:

pyenv virtualenv 3.8.18 procustodibus-broker


Activate the virtualenv:

pyenv local procustodibus-broker 3.8.18 3.9.18 3.10.13 3.11.7 3.12.1


Install tox:

pip install tox


Install pre-commit and pre-push hooks:

tox -e pre-commit -- install
tox -e pre-commit -- install -t pre-push

Dev tasks
List all tox tasks you can run:
tox -av

Run unit tests in watch mode:
tox -e watch

Run all (docker-based) installer tests:
docker-compose -f test_install/docker-compose.yml build --pull
tox -e py38 -- test_install

Manually run pre-push hook on all version-controlled files:
tox -e pre-commit -- run -a --hook-stage push

Contributing

Code of Conduct
File a Bug
Report a Vulnerability
Submit a Patch

Resources

Home page: https://www.procustodibus.com/
Documentation: https://docs.procustodibus.com/guide/integrations/brokers/
Changelog: https://docs.procustodibus.com/guide/integrations/brokers/#changelog
Issue tracker: https://todo.sr.ht/~arx10/procustodibus
Mailing list: https://lists.sr.ht/~arx10/procustodibus
Source code: https://git.sr.ht/~arx10/procustodibus-broker

License
The MIT License