> For the complete documentation index, see [llms.txt](https://docs.snyk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snyk.io/scan-fix-and-prevent/scan-with-snyk/snyk-api-web/discover-new-targets/scan-akamai-connection-asset-discovery.md).

# Scan an Akamai connection for asset discovery

How to scan an Akamai connection for asset discovery in Snyk API and Web

APIs often operate without the direct oversight of security teams, making them difficult to track and protect. To run a security scan on an API, you first need its specification file (schema), but finding the correct, up-to-date schema for every API in your organization can be a significant challenge.

This guide shows you how to connect your Akamai account to Snyk API & Web. This integration automatically discovers the APIs managed in your Akamai account and imports their schemas, so you can add them as targets in Snyk with a single click.

## Prerequisites

Before you start, you must have administrator access to your organization's Akamai API Security portal to retrieve the required API credentials.

## Get your Akamai API credentials

To allow Snyk to access your assets, obtain API credentials from your Akamai API Security tenant.

1. Log in to the Akamai API Security portal.
2. From your account's main navigation menu, select **Settings**.
3. From the **Settings** menu, select **User Management**.
4. Select the **Service Accounts** tab.
5. Click **Create Service Account** to open the configuration form.
6. Enter a name and a duration, then click **Save**.
7. Copy the following two values displayed in the **Service Account Credentials** window and save them in a secure location:
   * `Client ID`
   * `Client Secret`

{% hint style="warning" %}
The `Client Secret` is shown only once. Copy it before leaving the page. You need these credentials for the next step.
{% endhint %}

## Add the Akamai connection in Snyk API & Web

Use the credentials you created to connect your Akamai account in Snyk. You can do this from either the global **Integrations** page or the **Discovery** page.

### From the Integrations page

1. In your Snyk API & Web account, navigate to **Settings** > **Integrations**.
2. Locate the **Akamai** integration module.
3. Enter your credentials obtained from Akamai:
   * Akamai Server URL
   * Akamai Client ID
   * Akamai Client Secret
4. Click **Save**.

### From the Discovery page

1. In your Snyk API & Web account, navigate to the **Discovery** page.
2. Click **Add source**.
3. From the list of sources, select **Akamai**.
4. Enter your credentials obtained from Akamai:
   * Akamai Server URL
   * Akamai Client ID
   * Akamai Client Secret
5. Click **Connect**.

## View your discovered assets

After a successful connection, Snyk immediately begins importing your domains from Akamai. This process runs periodically to keep your inventory up to date.

You can view these domains by navigating to **Targets** > **Domains**. After Snyk imports your domains, it automatically runs a discovery scan on them to find the associated APIs. After this scan completes, Snyk lists your discovered assets on the **Discovery** page. For each API, a **{...}** icon indicates that its schema is available.

## Add a discovered API as a target

After your API assets appear in the **Discovery** list, you can add them as targets.

1. Navigate to the **Discovery** page.
2. To find API assets, use the following filters:
   * Filter by **Type** > **API** to display only API assets.
   * Filter by **Source** > **Akamai** to display assets imported from this integration.
3. Click **Add Target** on the corresponding row.

Snyk automatically configures the API as a new target with its schema pre-populated, making it ready for security testing. After you add the asset as a target, click **Scan** to get started.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.snyk.io/scan-fix-and-prevent/scan-with-snyk/snyk-api-web/discover-new-targets/scan-akamai-connection-asset-discovery.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
