Akamai EdgeDNS

Since: v3.9.0

Akamai edgedns supersedes FastDNS; implementing a DNS provider for solving the DNS-01 challenge using Akamai EdgeDNS

  • Code: edgedns

Here is an example bash command using the Akamai EdgeDNS provider:

AKAMAI_CLIENT_SECRET=abcdefghijklmnopqrstuvwxyz1234567890ABCDEFG= \
AKAMAI_CLIENT_TOKEN=akab-mnbvcxzlkjhgfdsapoiuytrewq1234567 \
AKAMAI_HOST=akab-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.luna.akamaiapis.net \
AKAMAI_ACCESS_TOKEN=akab-1234567890qwerty-asdfghjklzxcvtnu \
lego --email myemail@example.com --dns edgedns --domains my.example.org run

Credentials

Environment Variable Name Description
AKAMAI_ACCESS_TOKEN Access token, managed by the Akamai EdgeGrid client
AKAMAI_CLIENT_SECRET Client secret, managed by the Akamai EdgeGrid client
AKAMAI_CLIENT_TOKEN Client token, managed by the Akamai EdgeGrid client
AKAMAI_EDGERC Path to the .edgerc file, managed by the Akamai EdgeGrid client
AKAMAI_EDGERC_SECTION Configuration section, managed by the Akamai EdgeGrid client
AKAMAI_HOST API host, managed by the Akamai EdgeGrid client

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information here.

Additional Configuration

Environment Variable Name Description
AKAMAI_POLLING_INTERVAL Time between DNS propagation check. Default: 15 seconds
AKAMAI_PROPAGATION_TIMEOUT Maximum waiting time for DNS propagation. Default: 3 minutes
AKAMAI_TTL The TTL of the TXT record used for the DNS challenge

The environment variable names can be suffixed by _FILE to reference a file instead of a value. More information here.

Akamai credentials are automatically detected in the following locations and prioritized in the following order:

  1. Section-specific environment variables (where {SECTION} is specified using AKAMAI_EDGERC_SECTION):
    • AKAMAI_{SECTION}_HOST
    • AKAMAI_{SECTION}_ACCESS_TOKEN
    • AKAMAI_{SECTION}_CLIENT_TOKEN
    • AKAMAI_{SECTION}_CLIENT_SECRET
  2. If AKAMAI_EDGERC_SECTION is not defined or is set to default, environment variables:
    • AKAMAI_HOST
    • AKAMAI_ACCESS_TOKEN
    • AKAMAI_CLIENT_TOKEN
    • AKAMAI_CLIENT_SECRET
  3. .edgerc file located at AKAMAI_EDGERC
    • defaults to ~/.edgerc, sections can be specified using AKAMAI_EDGERC_SECTION
  4. Default environment variables:
    • AKAMAI_HOST
    • AKAMAI_ACCESS_TOKEN
    • AKAMAI_CLIENT_TOKEN
    • AKAMAI_CLIENT_SECRET

See also:

More information