Skip to content

Akamai

The Akamai integration connects Escape ASM to your Akamai account. Escape pulls hostnames and APIs from Edge DNS, Property Manager, and API Definitions so they land in your inventory for monitoring and testing.

Discovered Resources

Escape discovers and inventories:

  • Edge DNS hostnames: Domains and records from zones managed in Akamai Edge DNS
  • Property Manager hostnames: Customer-facing domains (cnameFrom) declared on Property Manager properties
  • API services: REST APIs from Akamai API Definitions, including hosts, base paths, and endpoint methods

Discovered items become assets in Escape ASM (APIs, DNS hosts, web apps). Downstream fingerprinting can classify what each hostname serves.

DNS-Zone Discovery

Escape uses the DNS-Zone Record Management API to list Edge DNS zones, then reads the recordsets in each zone. Record names that look like domains become DNS host assets. This covers DNS you manage in Akamai, including records that are not tied to a Property Manager property.

Property Manager Discovery

Escape walks Property Manager groups and properties, then collects each property's cnameFrom hostnames. Those domains become DNS host assets even when they are not present as Edge DNS records in the same account.

API Definition Discovery

Escape lists endpoints from the API Definitions API, then loads each endpoint version's resources (paths and HTTP methods). For every declared host and base path, Escape creates a structured REST API asset with its endpoints. Use this when you want API inventory from Akamai API Gateway, not hostname-only discovery.

Generate Akamai API Client Credentials

  1. From the side menu, open Identity & Access under Account Admin.
  2. Click Create API Client.
  3. Choose the client type that fits your use case. Select Advanced if you need to set specific API permissions.
  4. Under APIs, choose Select APIs, then enable these APIs with READ-ONLY access (use Change API Restrictions if needed):
    • API Definition: API and endpoint discovery
    • Property Manager API: Property hostname discovery
    • DNS-Zone Record Management: Edge DNS discovery
  5. On the API Client details page, copy client_secret, host, access_token, and client_token into Escape ASM.

Important: Akamai shows client_secret only once during creation. Download or securely store the credential immediately.