Centinel AnalyticaCentinel Analytica
Platforms

Akamai EdgeWorkers

Deploy Centinel Analytica protection on your Akamai property using EdgeWorkers.

Overview

This quickstart guides you through deploying Centinel Analytica server-side validation on Akamai using EdgeWorkers. Allow 15-30 minutes for Property Manager changes to propagate across the Akamai network.

Prerequisites

  • Centinel secret key
  • Akamai Control Center access
  • Property Manager access for the property you want to protect
Download the package
  1. Download centinel-akamai-edgeworker.zip.
  2. Extract the archive to get main.js and bundle.json.
Create the EdgeWorker
  1. Log into Akamai Control Center.
  2. Go to CDN → EdgeWorkers.
  3. Click Create EdgeWorker ID.
  4. Enter a name (for example centinel-protection).
  5. Select your Group and Resource tier.
  6. Click Create EdgeWorker ID.
Upload the code
  1. Select the EdgeWorker you just created.
  2. Click Create Version.
  3. Upload the main.js and bundle.json files from the extracted archive.
  4. Click Create Version.
Configure the validator route

The EdgeWorker calls the Centinel validator via an internal path. You need to route /centinel-validate to the Centinel API.

  1. Go to CDN → Properties and select your property.
  2. Click Edit New Version to create a draft.
  3. Under Property Configuration, click Add Rule.
  4. Name the rule Centinel Validator.
  5. Add a Criteria:
    • Match Type: Path
    • Match Operator: matches one of
    • Value: /centinel-validate
  6. Add a BehaviorOrigin Server:
    • Origin Server Hostname: validator.centinelanalytica.com
    • Forward Host Header: Origin Hostname
    • Origin SSL Certificate Verification: Yes
  7. Add a BehaviorModify Outgoing Request Path:
    • Action: Replace Entire Path
    • Replace With: /validate
  8. Add a BehaviorCaching:
    • Caching Option: No Store
  9. Click Save.

Important

Make sure the EdgeWorker behavior is not applied to the /centinel-validate rule to avoid recursion.

Set Property Manager variables
  1. In your property configuration, go to Property Variables.
  2. Add the following variables:
VariableValue
PMUSER_EW_CENTINEL_SECRET_KEYYour Centinel secret key
  1. (Optional) Add additional variables from the Configuration Reference below.
  2. Click Save.
Attach the EdgeWorker
  1. In your property, add or edit a rule where you want Centinel protection.
  2. Add a BehaviorEdgeWorkers.
  3. Select your centinel-protection EdgeWorker ID.
  4. Click Save.

Tip

Apply the EdgeWorker to your default rule to protect all paths, or add it to specific rules to protect only certain sections of your site.

Activate the property
  1. Click Activate in Property Manager.
  2. Select Staging for initial testing, or Production when ready.
  3. Add activation notes and click Activate.
  4. Wait for the activation to complete (approximately 15-30 minutes).
Verify deployment
  • Browse your website to confirm normal traffic flow.
  • Verify that static assets (.js, .css, .png, etc.) load without delays.
  • Set PMUSER_EW_CENTINEL_ENABLE_LOGGING to true and check the X-Centinel-Log response header for validation outcomes.

Configuration Reference

Required Variables

VariableTypeDescription
PMUSER_EW_CENTINEL_SECRET_KEYstringYour Centinel secret key for API authentication.

Optional Variables

VariableTypeDefaultDescription
PMUSER_EW_CENTINEL_TIMEOUTnumber300Validator API timeout in milliseconds.
PMUSER_EW_CENTINEL_ENABLE_LOGGINGbooleanfalseSet to true to add X-Centinel-Log response header for debugging.
PMUSER_EW_CENTINEL_PROTECTED_PATHS_INCLUSIONstringRegex pattern to protect only matching paths. Leave empty to protect all paths.
PMUSER_EW_CENTINEL_PROTECTED_PATHS_EXCLUSIONstringRegex pattern to skip validation. Static assets are excluded by default.

Changelog

  • 1.0.0 - Initial release.