Integration Guide

Step-by-step guide to integrate Killbot into your application.


With this integration guide, we’ve made it as easy as possible to quickly get up and running with an end-to-end embedded Killbot integration. Please see our Shortlink feature if you're only looking to create unique links to share with your customers.
In this guide, you will:
We recommend reading our Flow Overview for a look at key concepts and a diagram of an end-to-end integration. Integration for other technologies is still in development, but you can integrate them using our REST API.
Killbot blocker has several setting parameters and terms that you need to know as below, please click the link for more information:
  1. 1.
    Bot Type
  2. 2.
  3. 4.

Integrate Killbot Blocker

In this installation guide, you will install Killbot Blocker in or using:

PHP Web Base Application

  • Upload the /killbot/ folder to the website and put writable permissions on the /killbot/logs/ folder.
  • Change the /killbot/config.php config for yourself (change the active status, API key, and bot or threats users redirection page). Register to get 3 days free trial period to test the cloud version. Below are the contents of the config.php file that you need to configure.
'active' => true, // If 'true' will set blocker protection active, and 'false' will deactive protection
'apikey' => 'YOUR_APIKEY', // Your API Key from
'bot_redirect' => '404' // Bot will be redirect to this URL or you can change with 403, 404, suspend or cloudflare.
  • You can activate and deactivate the protection by setting the parameter 'active'. You need to enter your API Key which was obtained from the Killbot Developer page in the 'apikey' parameter. Then you can set the page or URL that malicious visitors will access in the 'bot_redirection' parameter. The redirection bot variations you can choose from are as follows:
Will show 403 Forbidden page.
Will show 404 Not Found page.
Will show suspend page.
Will show fake CloudFlare error page.
Will redirect malicious visitors to a specific URL for example you can set to
  • To the beginning of PHP scripts that need to be protected or to some general script (for example: config.php, function.php, etc.) after <?php add:
Connection for different CMS (the path is specified from the root directory of the site):
  1. 1.
    D-zeus (doorway generator) in index.php
  2. 2.
    DataLife Engine (DLE) in index.php
  3. 3.
    Diafan in index.php
  4. 4.
    Drupal in index.php
  5. 5.
    Joomla in index.php
  6. 6.
    MODX in index.php
  7. 7.
    MyBB in inc/config.php
  8. 8.
    OpenCart in index.php
  9. 9.
    PunBB and FluxBB in config.php
  10. 10.
    Webasyst in index.php
  11. 11.
    WordPress in wp-config.php
  12. 12.
    Битрикс in index.php and urlrewrite.php (or only in /bitrix/php_interface/init.php)
  • So that the implementation example will be as below:
* Used to store website configuration information.
* @var string or null
function config($key = '')
$config = [
'name' => 'Simple PHP Website',
'site_url' => '',
'pretty_uri' => false,
'nav_menu' => [
'' => 'Home',
'about-us' => 'About Us',
'products' => 'Products',
'contact' => 'Contact',
'template_path' => 'template',
'content_path' => 'content',
'version' => 'v3.1',
return isset($config[$key]) ? $config[$key] : null;
  • The installation is complete, you can monitor and make additional settings on the Killbot Blocker page.


You who use the WordPress platform don't need to be difficult to integrate Killbot with your website. We have released a plugin that can help you.
  • Go to Plugins > Installed Plugins, then click Add New
  • Click Upload Plugin then upload plugin which has been downloaded before. After that click Install Now.
  • After the plugin is installed you still need to activate it, so click the Activate Plugin button.
  • A new menu will appear, namely the Killbot Blocker menu under the Dashboard menu. Click the menu to enter the API Key and make arrangements.
  • You need to enter an API Key which you can get at Killbot Developer page. Then there are several settings that need to be entered, such as the URL address that will be accessed by bot visitors, then the IP whitelist and also the status of the plugin is active or not. After entering the API Key and activating the plugin status, Killbot can be used on your WordPress website.
  • The installation is complete, you can monitor and make additional settings on the Killbot Blocker page.

Manage Killbot Blocker

  • The following is information about the forms in the Killbot Blocker feature which can be used to manage Blocker:
Choose any device that can enter the destination domain.
Blocked Type
Choose any visitors who are allowed to enter the destination domain. The rest can be read on the Blocked Type page.
Blocked Level
Select the security level to keep out bad users. The rest can be read on the Blocked Level page.
Which countries can access the designated domain. You can customize it via the Customize Bot Redirection page.
Select ON to activate WAF. The rest can be read on the Firewall page.