Documentation

ASM Akamai Integration

🚧

Special privileges required

This feature is only available to ASM administrators.

Attack Surface Management (ASM)'s Akamai integration gives you more visibility by pulling both DNS records and CDN hostnames from Akamai directly into the ASM platform as a Seed.

Adding this integration requires two steps: 

  1. Create API Key in the Akamai API Clients utility
  2. Provide Akamai API Credentials for ASM integration

Create API Key in Akamai

  1. Once authenticated with Akamai, go to https://control.akamai.com/apps/identity-management/#/tabs/users/list.
  2. From the Identity and Access Management menu, select the Users and API Clients tab (1) and click Create API client (2).
Red boxes highlight the Users and API Client tab and Create API client button.
  1. In the Select API client type section, select the Service account tab (1)  and click Set API client options (2).
Red boxes highlight the set api client button.
  1. On the Details page, fill in the required fields and click Select APIs.
Red boxes highlight the select APIs.

  1. Select and configure APIs.

    1. Search for the APIs you wish to pull downstream:
    • DNS - Zone Record Management (DNS records)

    ℹ️

    The DNS - Zone Record Management API is required for this integration.

    • Property Manager (PAPI)  (CDN hostnames)
    1. For each applicable API, set the Access level to READ-ONLY.
    2. Click Submit.

    ℹ️

    As an example, a DNS record is shown here, but this process is similar for a CDN hostname, also known as Property Manager (PAPI).

  2. Back on the Details page, click Select groups and set the Role to Viewer for any groups that will be sending data to the ASM API. Click Submit.

Red boxes highlight the select groups button. Red boxes highlight the select APIs.
  1. After reviewing your entries on the Details page, select the acknowledgement checkbox (1) and click Create API client (2).
Red boxes highlight the select APIs.

ℹ️

Only a DNS record API is shown in the preceding example. Depending on your setup, a Property Manager (PAPI) API may also be listed:

  1. Click Create credential and then download or copy the credential information. This is required to complete the Akamai API integration in ASM.
Red boxes highlight the select APIs. Red boxes highlight the select APIs.

Provide Akamai API Credentials for ASM Integration

  1. From the Projects and Settings menu in ASM, select the appropriate Project then click Account Settings.
Red boxes highlight the Users and API Client tab and Create API client button.
  1. Click Integrations.
Red boxes highlight the Users and API Client tab and Create API client button.
  1. From Inbound Integrations, click Add New for Akamai.
Red boxes highlight the Users and API Client tab and Create API client button.
  1. Paste the Client Secret, Host, Access Token, and Client Token values from the preceding section into the appropriate fields and click Connect.
Red boxes highlight the Users and API Client tab and Create API client button.

  1. Connect the integration to the appropriate Collection.

    1. Click Collections and click Collection Settings for the Collection that you want to connect the integration to.
Red boxes highlight the Users and API Client tab and Create API client button.
  1. Select the Integrations tab.
Red boxes highlight the Users and API Client tab and Create API client button.
  1. Select Connect Integration and Set-up the integration.
Red boxes highlight the Users and API Client tab and Create API client button.

The integration is immediately added to the Collection.

💡

Click to remove the integration from this Collection.

  1. Click to close the Connect Integration pane. Click Scan Collection to update your Collection with the current settings and integrations. Otherwise, your newly configured integration is incorporated at your regularly scheduled scan interval.
Red boxes highlight the Users and API Client tab and Create API client button.

Updated 14 days ago