Installation

Prerequisites

To install Akamai EdgeWorker Enforcer, make sure you have access to Akamai’s Property Manager, EdgeWorkers, and NetStorage services.

EdgeWorker Installation Overview

The Akamai EdgeWorker installation has four steps:

  1. Compile and upload the PerimeterX Akamai EdgeWorker.
  2. Add the required static files to your Akamai NetStorage.
  3. Add the required Property Manager rules to your Akamai Property.
  4. Configure the enforcer by adding the relevant Property Variables to your Akamai Property.

Uploading the PerimeterX EdgeWorker Code

PerimeterX will provide a zipped file with the Akamai EdgeWorker JavaScript code. In your Akamai account, navigate to the EdgeWorker section and create a new EdgeWorker with the provided file. Click into the created EdgeWorker and activate it in your desired environment (staging or production).

Uploading Static Files to NetStorage

PerimeterX will also provide you with a number of static (CSS, JS, and/or HTML) files for you to add into your Akamai NetStorage File Manager. Your Akamai Property will refer to this NetStorage account to retrieve these files.

Adding PerimeterX Property Manager Rules

For the PerimeterX EdgeWorker to function properly in your Akamai Property, you will need to add the following rules at the very end of the Akamai Property Configuration. Refer to the outline and screenshots below for how to configure these rules.

  • PX Rules
    • PX-Worker Rule
    • PXSapi
      • PX-Activities
      • PXAPI-Risk
      • PXFP-Client
      • PXFP-Captcha
      • PXFP-XHR
      • PX-Telemetry
    • PX Block
  • PX NetStorage
  • PX Datastream

Screenshots of the above rules are found below

PX RulesPX Rules

PX Rules

PX-Worker RulePX-Worker Rule

PX-Worker Rule

PXSapiPXSapi

PXSapi

PX-ActivitiesPX-Activities

PX-Activities

PXAPI-RiskPXAPI-Risk

PXAPI-Risk

PXFP-ClientPXFP-Client

PXFP-Client

PXFP-CaptchaPXFP-Captcha

PXFP-Captcha

PXFP-XHRPXFP-XHR

PXFP-XHR

PX-TelemetryPX-Telemetry

PX-Telemetry

PX BlockPX Block

PX Block

PX NetStoragePX NetStorage

PX NetStorage

PX DatastreamPX Datastream

PX Datastream


Did this page help you?