Akamai
Read time: 3 minutes
Last edited: Oct 30, 2024
The Akamai integration is available to customers on an Enterprise plan. To learn more, read about our pricing. To upgrade your plan, contact Sales.
Overview
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 must install and configure the Akamai SDK to use this integration. To learn more, read Akamai SDK reference.
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.
If you are using Akamai's EdgeWorkers, but not using the Akamai EdgeKV, this integration is not required. However, you still must install and configure the Akamai SDK to read flag data from your Akamai EdgeWorkers. To learn more, read Akamai SDK reference.
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.
Akamai EdgeKV enforces value size limits that might be smaller than your LaunchDarkly flag data in a given environment.
To learn more, read about EdgeKV limits.
To create a new Akamai integration for your environment:
- Navigate to the Integrations page and find "Akamai EdgeWorkers."
- Click Add integration. The "Create Akamai EdgeWorkers configuration" panel appears.
- Give the integration a human-readable Name.
- Select a LaunchDarkly Environment. You cannot change this after you configure the integration.
- 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.
- Select the Akamai Network environment that this integration should connect to. You can change this after you configure the integration.
- Enter the EdgeKV namespace and EdgeKV group. These are the identifiers from your Akamai account where you will store LaunchDarkly flag information.
- 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.
- After reading the Integration Terms and Conditions, check the I have read and agree to the Integration Terms and Conditions checkbox.
- (Optional) Click Validate connection. This sends a test request to your Akamai EdgeWorkers using the information provided.
- 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:
- Navigate to the Integrations page and find "Akamai EdgeWorkers."
- Click the arrow menu to display the existing Akamai EdgeWorkers integrations.
- 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.