Skip to content

fernandocastrovilar/whiteblocker

Repository files navigation

White Blocker

White Blocker is a software which provides an automatic blocking of IPs which tries to scan or penetrate into the system and graphic administration for block incoming ip traffic.

Installation

In order to run WhiteBlocker and install all its dependencies, it will be necessary to have pipenv installed.

apt-get install pipenv

Then, clone repo and install dependencies:

git clone https://github.com/fernandocastrovilar/whiteblocker.git && cd whiteblocker/
pipenv install

Configuration

The only configuration needed is to set the correct parameters for having notifications working and credentials for login into the web interface.

To change the default username/password of web app, on config.json should change the param "username" and "password" with the one you want.

To get email notifications, just edit the "config.json" file editing the username/password with the credentials of your google account and the recipient with the email where you want to receive the notifications:

The other part of the config file is for set the parameters from a telegram bot, which can be used too to receive live notifications about events on WhiteBlocker.

For this, you will need to edit your bot URL and your chat ID.

License

GNU GPLv3