Installing the module

Import the BotGuard package digital signature key^*:

apt install curl gpg ca-certificates lsb-release apt-utils whiptail apt-transport-https software-properties-common sudo
curl -fsSL https://repo.botguard.net/botguard.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/botguard.gpg >/dev/null

Add the BotGuard repository to the system repositories:

echo "deb [signed-by=/usr/share/keyrings/botguard.gpg] https://repo.botguard.net/debian $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/botguard.list
apt update

Install the BotGuard Apache module:

apt install libapache2-mod-botguard

Restart the Apache service:

service apache2 restart

Make sure BotGuard module is loaded successfully:

apachectl -M 2>/dev/null | grep botguard

As a result of executing this command, the following text should be displayed:

 botguard_module (shared)

To enable or disable the module, use the a2enmod botguard and a2dismod botguard commands respectively.

Setting the parameters of the module

After installation, the module will be disabled, as it requires preliminary configuration for its operation. To configure the module, run the command:

dpkg-reconfigure libapache2-mod-botguard

Using this command, you can configure the parameters necessary for the module to work in interactive mode:

Instead, you can change the settings of the module by editing its configuration file /etc/apache2/mods-available/botguard.conf:

1. Find the line # BotguardPrimaryServer "xxx.botguard.net" and remove the "#" symbol (uncomment the line). Replace xxx.botguard.net with the address of the primary BotGuard server assigned to your web server.
2. Find the line # BotguardSecondaryServer "yyy.botguard.net" and remove the "#" symbol (uncomment the line). Replace yyy.botguard.net with the address of the secondary BotGuard server.
3. One Apache server can serve multiple domains ("virtual hosts"). You can activate BotGuard protection either for all domains or for selected domains only.
   • To enable BotGuard protection for all the domains, find the line BotguardCheck offin the configuration file of the BotGuard module and replace it with BotguardCheck on.
   • To activate protection only for some domains, the line BotguardCheck off must be left in the BotGuard module configuration file. Instead, add a BotguardCheck on line to the description of each virtual host to be protected in the Apache configuration files (<VirtualHost …>…</VirtualHost>). In addition, the module can be activated for any site separately using the .htaccess file:

     <IfModule botguard_module>
     	BotguardCheck on
     </IfModule>

4. Reload Apache configuration for the module settings to take effect:

   service apache2 reload

Diagnostic messages and error messages are logged to the /var/log/apache2/error.log, file, depending on Apache settings.

Installing the module

Import the BotGuard package digital signature key^*:

rpm --import https://repo.botguard.net/botguard.gpg

Add the BotGuard repository to the system repositories:

yum install epel-release yum-utils
yum-config-manager --add-repo https://repo.botguard.net/BotGuard.repo

The version of the BotGuard Apache module must match with the version of Apache web server installed. Your Apache may have been installed from the operating system repository, or from an additional repository. Depending on the repository used and the version of Apache, the installation procedure may differ slightly.

Find out the source of your installed Apache version:

echo -e 'httpdnhttpd24-httpdnea-apache24' | LANG=C xargs -I "#" yum info "#" 2>/dev/null | grep -E 'Packages|Name|From repo'

As a result of executing this command, a list of available and installed Apache versions will be displayed:

Installed Packages
Name        : ea-apache24
From repo   : cl-ea4

Next, depending on the source of the installed package, install the appropriate version of the BotGuard module:

yum install mod_botguard

service httpd restart

apachectl -M | grep botguard

 botguard_module (shared)

yum install httpd24-mod_botguard

service httpd24-httpd restart

scl enable httpd24 bash
apachectl -M | grep botguard

 botguard_module (shared)

yum install ea-apache24-mod_botguard

service ea-apache24 restart

apachectl -M | grep botguard

 botguard_module (shared)

Setting the parameters of the module

After installation, the module will be disabled, as it requires preliminary configuration for its operation. To configure the module, edit its config file set to the path given above.

1. Find the line # BotguardPrimaryServer "xxx.botguard.net" and remove the "#" symbol (uncomment the line). Replace xxx.botguard.net with the address of the primary BotGuard server assigned to your web server.
2. Find the line # BotguardSecondaryServer "yyy.botguard.net" and remove the "#" symbol (uncomment the line). Replace yyy.botguard.net with the address of the secondary BotGuard server.
3. One Apache server can serve multiple domains ("virtual hosts"). You can activate BotGuard protection either for all domains or for selected domains only.
   • To enable BotGuard protection for all the domains, find the line BotguardCheck off in the configuration file of the BotGuard module and replace it with BotguardCheck on.
   • To activate protection only for some domains, the line BotguardCheck off must be left in the BotGuard module configuration file. Instead, add a BotguardCheck on line to the description of each virtual host to be protected in the Apache configuration files (<VirtualHost …>…</VirtualHost>). In addition, the module can be activated for any site separately using the .htaccess file:

     <IfModule botguard_module>
     	BotguardCheck on
     </IfModule>

4. Reload Apache configuration for the module settings to take effect:

   service httpd reload

Diagnostic messages and error messages are logged to the /var/log/httpd/error.log or /var/log/apache2/error.log files, depending on Apache settings.