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
| Capability | Description |
|---|---|
| CDN Inventory | Collects properties, hostnames, origins, and delivery configuration. |
| Certificate Visibility | Tracks certificate details and expiration data when permitted. |
| Account Context | Collects Akamai account, contract, and group metadata. |
| Performance Monitoring | Provides delivery and caching data where the enabled APIs permit it. |
| CMDB Enrichment | Maps 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.
| Field | Requirement | Description |
|---|---|---|
| akamai_host | Mandatory | Akamai API hostname, such as akab-<key>.luna.akamaiapis.net. |
| client_token | Mandatory | EdgeGrid client token generated for the API client. |
| client_secret | Mandatory | EdgeGrid client secret. Copy it when created and store it securely. |
| access_token | Mandatory | EdgeGrid 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.
| Data | Coverage |
|---|---|
| Account | Account, contract, and group metadata. |
| Properties | CDN properties, versions, hostnames, and delivery settings. |
| Origins and Domains | Origin domains, CNAMEs, and Site Shield mappings. |
| Certificates and Security | SSL/TLS certificate and security configuration data when permitted. |
| Performance | Delivery 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.