Press enter to see results or esc to cancel.

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.