Introduction
How to deploy Centinel Analytica on your site and customize protection settings.
Before you begin
- Create your account in the Centinel Analytica dashboard.
- You'll need:
- your site key (public, used by the browser script)
- your secret key (server-only, used for
/validate)
How it works
Centinel has three parts:
- Server validation (required): your backend, or a platform integration, calls the validation API for each protected request and acts on the decision (
allow,block, orredirect). The validator issues the_centinelsession cookie, and your response sets it. - Policy rules: rules select bot detection and actions for matching requests. The dashboard's default rule enforces nothing, because the validator skips it. Add and verify an explicit matching rule before you rely on a policy action.
- Browser script (optional): collects browser and network signals that server-side data alone cannot see, and mirrors the
_centinelcookie. Detection works without it, with a smaller signal set.
Next steps
Copy your keys from the dashboard. Review the default policy. Add and order path-specific rules where you need different behavior.
Go to: Dashboard and Policy Rules
Wire up validation: use a platform integration, or call /validate from your backend.
Go to: Platform integrations or Validation
Add the browser script for stronger detection on pages visitors load.
Go to: Scripts
Dashboard
Find your site key and secret key, and see what the /validate response can include.
Scripts
Install the browser script and wait for initialization before protected actions.
Validation
Call /validate from your backend and enforce allow, block, and redirect safely.
Policy Rules
Decide which requests are protected, and whether they are allowed, blocked, rate-limited, or watched.
Glossary
Plain-English definitions for decisions, visitor types, and block-reason categories.
Security groups
Grant scoped read/write/admin access per resource. Default Admins/Members groups, deny rules, and how the resolver decides.
Platform guides
If you're integrating on a specific platform, start here. All platforms has the full list grouped by where enforcement runs.
Akamai EdgeWorkers
Apache HTTP Server
ASP.NET Core
AWS CloudFront
Azure Functions
Cloudflare Workers
Cloudflare Workers (npm)
Drupal 7
Drupal 8+
F5 BIG-IP iRules
Fastly Compute (Rust)
Fastly VCL
HAProxy
Next.js
Nginx / OpenResty
Varnish
WordPress
Getting help
If you get stuck, reach out via your dashboard/support channel with:
- the URL you're protecting
- a sample
/validaterequest payload (redact secrets) - the decision you received and any
crawlermetadata (if enabled)