## Akamai integration

Akamai is a content delivery network (CDN), edge cloud, and security platform. Integrating Akamai with Frontegg lets your application purge cached content (Fast Purge / CCU), manage delivery configurations through Property Manager (PAPI), and query account and identity data (IAM) on behalf of your users — all through Frontegg's integration layer. Akamai APIs authenticate with EdgeGrid (EG1-HMAC-SHA256 request signing), so instead of an OAuth flow you provide the four EdgeGrid credentials from an API client's `.edgerc` file.

Prerequisites
- An [Akamai Control Center](https://control.akamai.com/) account
- Permission to create API clients (Identity & Access Management access)


### Connect Akamai

EdgeGrid credentials are issued to an **API client** that you create in Akamai Control Center. Each client carries its own access level and produces four values — **client token**, **client secret**, **access token**, and **host** — which Akamai bundles into a downloadable `.edgerc` file.

#### Step 1: Open API clients in Control Center

Sign in to [Akamai Control Center](https://control.akamai.com/), open the main menu, and go to **Identity & Access Management → API clients**. This page lists the API clients available to your account.

#### Step 2: Create a new API client

Click **Create API client**. Choose **Quick** to create a client that inherits your own account access and permissions — this is the fastest path and is sufficient for most integrations. If you need to scope the client explicitly, use the advanced option to select the API service access, groups, and read/write permissions the integration requires (for example, **CCU APIs**, **Property Manager (PAPI)**, and **Identity Management**).

#### Step 3: Download the credentials

In the **Credentials** section, click **Download** to save the `.edgerc` file. Open it in a text editor — it contains the four values you need:

| `.edgerc` key | What it is |
|  --- | --- |
| `client_secret` | The HMAC signing secret |
| `host` | Your account-specific API hostname (for example, `akab-xxxx.luna.akamaiapis.net`) |
| `access_token` | The client's access token |
| `client_token` | The client's client token |


Copy your credentials now
The client secret is shown only when the client is created. Store the `.edgerc` file securely and treat every value in it as a secret.

#### Step 4: (Optional) Find your account switch key

If you are a partner or agency managing another account, obtain the **account switch key** for the target account (Control Center → **Account admin → Manage accounts**, or via the IAM API). This routes every API call to that managed account. Leave it empty if your API client targets a single account.

### Configure the Frontegg portal

Once you have your `.edgerc` values, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → Akamai.
2. In **Client secret**, enter the `client_secret` value.
3. In **Akamai API host**, enter the `host` value, including the `https://` scheme (for example, `https://akab-xxxx.luna.akamaiapis.net`).
4. In **Client token**, enter the `client_token` value.
5. In **Access token**, enter the `access_token` value.
6. Optionally, in **Account switch key**, enter your account switch key. Leave it empty for single-account access.
7. Click **Save**.


Keep your credentials secure
Never share or commit your `.edgerc` values to version control.

### Additional resources

- [Create EdgeGrid authentication credentials](https://techdocs.akamai.com/developer/docs/set-up-authentication-credentials)
- [EdgeGrid authentication](https://techdocs.akamai.com/developer/docs/edgegrid)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)