Skip to content

Keep tabs on your fail2ban jail statuses with Slack.

License

Notifications You must be signed in to change notification settings

asdfdotdev/fail2slack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Unit Tests 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.7, 3.7.7, 3.8, 3.9, 3.10

Browse our build history at GitHub.

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]

options:
  -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. STRING of identifier to use. Default is hostname.

Result

Tests

For instructions on running test check out the README.

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.