Our Akamai integration utilizes Akamai's EdgeWorkers solution to provide you with a feature rich and robust waiting room service that works directly from Akamai's CDN network without the need for you to make any changes to your application code or web servers.

Prerequisites

  1. An active CrowdHandler account. If you haven't signed up already you can do so here.
  2. Access to the Akamai control panel with an active EdgeWorkers subscription. Please consult Akamai professional services if you're unsure if you meet this requirement.
  3. A supported Akamai Delivery Product.
    At the time of writing (14/11/2022) they are as follows:
    Ion
    Dynamic Site Accelerator (DSA)
    Adaptive Media Delivery
    Download Delivery
    Object Delivery API Acceleration


  4. A supported Akamai Delivery Method.

    At the time of writing (14/11/2022) they are as follows:
    Enhanced TLS
    Standard TLS *

    * Use of the Standard TLS delivery method will require you to reach out to an Akamai Support Engineer for EdgeWorkers to be manually enabled for your environment property. 


https://techdocs.akamai.com/edgeworkers/docs/limitations

Installation Steps

It is strongly advised to install and test on a staging environment prior to deploying  to your production environment. 

Estimated Installation Time - 3/4 hours

  1. Step 1 - Configure EdgeWorker
  2. Step 2 - Associate EdgeWorker with property
  3. Step 3 - Install CrowdHandler API Proxy
  4. Step 4a - Whitelabel Waiting Room Installation
    Step 4b - Whitelabel Waiting Room Compression
  5. Step 5 - Configure EdgeWorker Error Handler
  6. Step 6 - Activation
  7. Step 7 - Install CrowdHandler Javascript Integration
  8. Step 8 (optional) - Providing your CrowdHandler Engineer with Access to EdgeWorker Diagnostics.

What Next?

Once you have completed the Akamai integration steps we recommend checking out our getting started guide which will help familiarise you with creating and configuring waiting rooms from within the CrowdHandler control panel. If you've already installed the CrowdHandler Javascript integration, you can skip any references to that in the guide.

If you want to understand how our Akamai integration works under the hood our source code can be found here and a top-level process diagram can be found here