Skip to main content

Send fail2ban jail status updates to Slack.

Project description

fail2slack.py

Build Status codecov downloads

fail2slack lets you send fail2ban jail status updates to Slack with ease.

Compatibility

Python Version Module Version

fail2slack is developed for and tested with recent versions of Python, including:

  • 3.6, 3.7, 3.7.4, 3.8-dev

Browse our build history at Travis-CI.

Installation

pip install fail2slack

Install fail2slack using the Python package installer.

Dependencies for using fail2slack are available in the requirements file.

Usage

usage: __main__.py [-h] [-w WEBHOOK] [-d DELIVERY] [-j JAILS [JAILS ...]]
                   [-i IDENTIFIER]

optional arguments:
  -h, --help            show this help message and exit
  -w WEBHOOK, --webhook WEBHOOK
                        Slack webhook URL. Required if delivery method is 1.
  -d DELIVERY, --delivery DELIVERY
                        Delivery method: 0 = print, 1 = Slack webhook.
  -j JAILS [JAILS ...], --jails JAILS [JAILS ...]
                        Jails to include in status report. Required.
  -i IDENTIFIER, --identifier IDENTIFIER
                        Update identifier. 0 = exclude from message, STRING of
                        identifier to use. Default is hostname.

Tests

For instructions on running test check out the README.

Test coverage reports are available on Codecov.

Contributing

Feedback, bug reports, feature requests, and pull requests are welcome!

If you'd like to contribute to fail2slack please reference our code of conduct and contributing guides.

Project details


Download files

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

Files for fail2slack, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size fail2slack-0.2.0.tar.gz (5.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page