BotGuard DirectAdmin
DirectAdmin Integration Manual
BotGuard offers an integration plugin for the DirectAdmin control panel. We support the following Linux operating systems:
- Debian 10 ("buster"), 9 ("stretch"), 8 ("jessie")
- Ubuntu 20.04 ("focal"), 18.04 ("bionic"), 16.04 ("xenial")
- RHEL/CentOS 8, 7, 6
The integration procedure depends on the type of operating system used:
Requirements
BotGuard plugin supports Apache 2.4
You need to download the BotGuard module for Apache that matches your OS version (preferably, do it in the temporary directory):
curl -O https://repo.botguard.net/debian/pool/main/liba/libapache2-mod-botguard/libapache2-mod-botguard_1.0.8~$(lsb_release -cs)1_amd64.deb
Unpack downloaded .deb file:
ar x libapache2-mod-botguard_1.0.8~$(lsb_release -cs)1_amd64.deb
Copy extracted files to their targets and update config files:
cp ./etc/apache2/mods-available/botguard.conf /etc/httpd/conf/extra/httpd-botguard.conf cp ./usr/lib/apache2/modules/mod_botguard.so /usr/lib/apache/ echo 'LoadModule botguard_module /usr/lib/apache/mod_botguard.so' >> /etc/httpd/conf/extra/httpd-includes.conf echo 'Include conf/extra/httpd-botguard.conf' >> /etc/httpd/conf/extra/httpd-includes.conf
Restart Apache:
service httpd restart
Requirements
BotGuard plugin supports Apache 2.4
You need to download the BotGuard module for Apache that matches your OS version (preferably, do it in the temporary directory):
curl -O https://repo.botguard.net/centos/$(rpm -q --qf "%{VERSION}" $(rpm -q --whatprovides redhat-release))/os/x86_64/Packages/mod_botguard-1.0.8-1.el$(rpm -q --qf "%{VERSION}" $(rpm -q --whatprovides redhat-release)).x86_64.rpm
Unpack downloaded .deb file:
rpm2cpio mod_botguard-1.0.8-1.el$(rpm -q --qf "%{VERSION}" $(rpm -q --whatprovides redhat-release)).x86_64.rpm | cpio -idmv
Copy extracted files to their targets and update config files:
cp ./etc/httpd/conf.d/botguard.conf /etc/httpd/conf/extra/httpd-botguard.conf cp ./usr/lib64/httpd/modules/mod_botguard.so /usr/lib64/httpd/modules/ echo 'LoadModule botguard_module /usr/lib64/httpd/modules/mod_botguard.so' >> /etc/httpd/conf/extra/httpd-includes.conf echo 'Include conf/extra/httpd-botguard.conf' >> /etc/httpd/conf/extra/httpd-includes.conf
Restart Apache:
service httpd restart
Plugin Installation
1. Download the plugin archive here.
2. Unpack the plugin and move the files to DirectAdmin plugins directory:
ar -zxf botguard-directadmin.tar.gz
mv botguard-directadmin/botguard /usr/local/directadmin/plugins/
chown diradmin:diradmin -R /usr/local/directadmin/plugins/botguard
Using The Extension
Authorize as an administrator, navigate to the menu entry ‘Extra Features’ -> ‘BotGuard Bot Management’, provide your Botguard account details including API key and server addresses, and save settings
Authorize as a user (or switch to user from the administrator’s account). Select the domain from the drop-down list at the top of the screen and select menu entry ‘Extra Features’ -> ‘BotGuard Bot Management’:
Here you can enable Botguard protection for your website, manage protection rules, and view protection events.
Written By
