Back to Guides
CDNTroubleshooting

Akamai SSL Certificate Errors: Edge, Origin & Property Manager Fixes

Understand Akamai's two-certificate architecture and fix common SSL validation failures.

12 min readIntermediate
Akamai SSL Certificate Errors - Two certificates, two connections, twice the troubleshooting

Two-Certificate Architecture

Key Insight: Akamai uses TWO separate SSL/TLS connections. Problems with your edge certificate don't affect your origin certificate, and vice versa.

VisitorBrowser
HTTPS
Edge Certificate(Akamai manages)
Akamai EdgeCDN Server
HTTPS
Origin Certificate(Your responsibility)
Origin ServerYour Server

These are two completely separate SSL connections. Edge certificate issues affect visitors. Origin certificate issues affect Akamai's connection to your server.

Edge Certificate Options

Akamai offers several ways to secure the connection between visitors and the edge:

OptionCostBest ForDetails
Standard TLSFreeMost sitesShared SAN certificate
Enhanced TLS$$Compliance-sensitiveDedicated certificate
Third-PartyCert costFull controlBring your own cert
Let's EncryptFreeDedicated + freeAuto-renewed DV cert

Tip: Standard TLS works for most use cases. Enhanced TLS is required for PCI DSS compliance or when you need EV/OV validation visible to visitors.

Origin SSL Settings (Property Manager)

These settings control how Akamai validates your origin server's certificate:

Verification Modes

SettingWhat It DoesSecurity
TrustAccepts any cert including self-signed⚠️ Insecure
VerifyValidates against CA bundle✓ Good
Verify + HostnameValidates cert AND hostname match✓ Best

Warning: "Trust" mode is insecure

Like Cloudflare's "Flexible" mode, Trust disables certificate validation entirely. Use only for testing or when you have no other option. Never in production with sensitive data.

Other Important Settings

Origin Port

  • 80 - HTTP (no SSL)
  • 443 - HTTPS (SSL required)
  • • Custom ports supported

SNI (Server Name Indication)

  • • Enable if origin hosts multiple sites
  • • Required for shared hosting
  • • Sends hostname in TLS handshake

Common Errors & Fixes

Property Manager Checklist

Work through this checklist when setting up or troubleshooting SSL:

Akamai vs Cloudflare: SSL Settings Comparison

SettingAkamaiCloudflare
No origin SSLPort 80 (HTTP)Flexible
Any origin certTrustFull
Valid origin certVerifyFull (Strict)
Valid + hostname matchVerify + Hostname ✓Full (Strict) ✓
Free origin certLet's EncryptCloudflare Origin CA

Debug with Pragma Headers

Akamai provides debug headers to help troubleshoot issues. Add Pragma headers to see detailed information about caching, SSL, and request routing:

# Basic debug headers
curl -I -H "Pragma: akamai-x-cache-on, akamai-x-get-request-id" https://yourdomain.com

# Full SSL debug (for certificate troubleshooting)
curl -I -H "Pragma: akamai-x-get-extracted-values, akamai-x-get-request-id, akamai-x-get-ssl-client-session-id, akamai-x-cache-on" https://yourdomain.com

Key response headers to look for:

  • X-Akamai-Request-ID - Unique request ID for support tickets
  • X-Cache - Shows TCP_HIT or TCP_MISS for cache status
  • X-True-Cache-Key - The actual cache key used

Frequently Asked Questions

Can I use a self-signed certificate with Akamai?

Yes, but only with "Trust" verification mode. This disables certificate validation entirely, which is insecure. For production, use Let's Encrypt or a proper CA certificate and enable "Verify" or "Verify + Hostname".

How long does edge certificate provisioning take?

Standard TLS (DV) typically provisions within minutes once DNS is correctly configured. Enhanced TLS with OV/EV validation can take 1-5 business days due to manual verification steps.

Why does my site work directly but fail through Akamai?

Your browser may accept certificates that Akamai won't. Common issues: missing intermediate certs (browsers may fetch them, Akamai doesn't), hostname mismatches, or SNI requirements. Test with openssl s_client to see what Akamai sees.

Do I need different certificates for edge and origin?

Yes, they're completely separate. The edge certificate secures visitor-to-Akamai traffic. The origin certificate secures Akamai-to-origin traffic. They can be from different CAs, have different hostnames, and expire at different times.

What CAA records does Akamai need?

Akamai uses DigiCert, Let's Encrypt, and GlobalSign for certificate issuance. Add CAA records allowing digicert.com, letsencrypt.org, and globalsign.com if you have CAA records configured.

Related Resources