Documents & Resources

Welcome to BotGuard Knowledge Base

BotGuard Knowledge Base

Please login to see your partner documents.Login

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.