← Back to Integration
CONTENT DELIVERY

Integration with Akamai CDN Integration with SPOG.AI

SPOG.AI integrates with Akamai CDN to centralize CDN configuration, property, hostname, contract, group, certificate, and delivery information. The integration enriches the CMDB for compliance, performance, and incident analysis.

Key Features

CapabilityDescription
CDN InventoryCollects properties, hostnames, origins, and delivery configuration.
Certificate VisibilityTracks certificate details and expiration data when permitted.
Account ContextCollects Akamai account, contract, and group metadata.
Performance MonitoringProvides delivery and caching data where the enabled APIs permit it.
CMDB EnrichmentMaps Akamai CDN components into SPOG.AI records.

How the Integration Works

SPOG.AI authenticates to Akamai with EdgeGrid credentials: host, client token, client secret, and access token. The connector calls the Akamai APIs permitted for the API client and normalizes returned CDN data into SPOG.AI.

Prerequisites

Before configuring the integration, ensure the following prerequisites are met:

  • Administrator access in SPOG.AI and Akamai Control Center.
  • An Akamai API client with access to the required contracts and APIs.
  • EdgeGrid credentials and network access to the Akamai API host over HTTPS.

Configuration

1. Enable Required Akamai APIs

Enable only the APIs needed for the subscribed services.

  • Content Delivery API: required for CDN properties, hostnames, and delivery configurations.
  • Certificate Provisioning API: optional for certificate details and expiry.
  • Enterprise Application Access, Application Security, and Content Purge APIs: optional based on scope.

2. Create an API Client

Create a client under Identity and Access Management > API Clients.

  • Select the required contracts, groups, and least-privileged permissions.
  • Create the credential and immediately copy the host, client token, client secret, and access token.
  • Download the EdgeGrid configuration file if required by your operating process.

3. Configure Akamai in SPOG.AI

Add Akamai Integration under Settings > Integrations.

  • Enter the four EdgeGrid fields, run Test Connection, save, and link the integration to the required appliance.

Configuration Fields

Use the fields below when creating the integration in SPOG.AI.

FieldRequirementDescription
akamai_hostMandatoryAkamai API hostname, such as akab-<key>.luna.akamaiapis.net.
client_tokenMandatoryEdgeGrid client token generated for the API client.
client_secretMandatoryEdgeGrid client secret. Copy it when created and store it securely.
access_tokenMandatoryEdgeGrid access token used to authenticate API requests.

Security and Connectivity

  • Use read-only permissions unless a documented workflow requires write access.
  • Store EdgeGrid credentials in a vault and rotate them periodically.
  • Allow HTTPS port 443 to the Akamai API hostname and allowlist appliance egress IPs where required.
  • Require TLS 1.2 or later and monitor Akamai audit logs.

Validation and Data Coverage

Run Test Connection, confirm Akamai records in SPOG.AI, and compare a sample property or delivery report with Akamai Control Center. Validate optional alert or webhook behavior only when configured.

DataCoverage
AccountAccount, contract, and group metadata.
PropertiesCDN properties, versions, hostnames, and delivery settings.
Origins and DomainsOrigin domains, CNAMEs, and Site Shield mappings.
Certificates and SecuritySSL/TLS certificate and security configuration data when permitted.
PerformanceDelivery reports, caching metrics, and synchronization history when available.

Uninstalling the Integration

  • Delete the Akamai integration in SPOG.AI.
  • Revoke the Akamai API client or credential.
  • Remove any EdgeGrid configuration file and appliance linking no longer required.