Platforms
Drupal 8+
Add Centinel Analytica to your Drupal 8+ website.
Overview
This guide covers installing, configuring, and verifying Centinel Analytica in Drupal 8+. You'll upload a .TAR.GZ module, enter your keys, choose what to protect (front-end, REST API), and create a block page.
Get your keys first
Go to https://dash.centinelanalytica.com/ and copy your Site Key and Secret Key.
Requirements
- Drupal 8 or higher
- Administrator access
- Ability to upload and configure modules
Download the module (.TAR.GZ)
Download Drupal 8+ Module. Keep the file compressed—don't decompress it.
Upload and activate the module
- Log in as administrator.
- Go to Extend in the main menu.
- Click Install new module.

- Once installation completes, go to Configuration and select Centinel Analytica Settings.

- Enter your API keys from the Centinel Analytica Dashboard.

- Site Key – paste from your dashboard.
- Secret Key – paste from your dashboard.
- Block Page URL – where users go when blocked (default:
/block). - Apply protection to – check the areas to protect:
- Front-end pages – public pages.
- API – JSON API routes.
Click Save configuration.
Cache
If needed, clear the cache at Configuration → Development → Performance.
Verify installation
In Centinel Analytica → Analytics you should see traffic appearing as you browse your site.
Changelog
v1.2
- Response headers from
/validateare now applied to all outgoing responses (block, redirect, and allow). Headers likeContent-Typeare no longer hardcoded — they come from the validator. - Validator API requests now include a
User-Agentheader identifying the integration name and version.
- 1.2 - Better Drupal-specific middleware.
- 1.1 - Added exclude paths option.
- 1.0 - Initial release.