Akamai

This topic explains how to use LaunchDarkly’s Akamai integration. This integration enables flag evaluation within Akamai EdgeWorker functions. The integration writes the latest flag data from the configured environment directly to an Akamai EdgeKV store in your account. It also sends any change to a flag or segment configuration in your selected environment to your Akamai EdgeKV, ensuring your store is always up to date.

You can use the Akamai integration to bootstrap your application with the latest client-side feature flags. This eliminates the initial remote call to LaunchDarkly, providing zero-latency client-side feature flags with no flash of original content or shift in content layout. The Akamai integration also enables flag evaluations within Akamai EdgeWorker functions. This means you can use your LaunchDarkly flags without an added latency from network requests.

Create an Akamai integration

For an Akamai integration to work, you need an Akamai account with at least one namespace and group. You must create one integration for each LaunchDarkly environment.

To create a new Akamai integration for your environment:

1. In LaunchDarkly, click the gear icon in the left sidebar to view Organization settings.
2. Click Integrations and find “Akamai EdgeWorkers.”
3. Click Add integration. The “Create Akamai EdgeWorkers configuration” panel appears.
4. Give the integration a human-readable Name.
5. Select a LaunchDarkly Environment. You cannot change this after you configure the integration.
6. In the Host field, enter the unique host domain to which LaunchDarkly should send requests. You can find this on the API client details page that’s linked from your Akamai “Identity and Access Management” dashboard. To learn more, read Akamai’s Create an API client with custom permissions documentation.
7. Select the Akamai Network environment that this integration should connect to. You can change this after you configure the integration.
8. Enter the EdgeKV namespace and EdgeKV group. These are the identifiers from your Akamai account where you will store LaunchDarkly flag information.
9. Enter the Client secret, Client token, and Access token. These are authentication credentials that you can generate from your Akamai Control Center. To learn more, read Akamai’s Create authentication credentials documentation.
10. After reading the Integration Terms and Conditions, check the I have read and agree to the Integration Terms and Conditions checkbox.
11. (Optional) Click Validate connection. This sends a test request to your Akamai EdgeWorkers using the information provided.
12. Click Save configuration.

Manage an Akamai integration

After you have created an Akamai integration, you can change its status, test it, or delete it.

Here’s how:

1. Navigate to the Integrations page and find “Akamai EdgeWorkers.”
2. Click the arrow menu to display the existing Akamai EdgeWorkers integrations.
3. Find your integration and click the pencil icon to edit. The “Edit Akamai EdgeWorkers configuration” panel appears.

Then complete one of the following actions:

• To change the status of an existing Akamai integration, toggle the Status to Off or On.
• To test an existing Akamai integration, click Validate connection. This sends a test request to your Akamai EdgeWorkers using your current configuration.
• To delete an existing Akamai integration, click Delete.