Akamai EdgeDNS
Akamai edgedns supersedes FastDNS; implementing a DNS provider for solving the DNS-01 challenge using Akamai EdgeDNS
- Code:
edgedns - Since: v3.9.0
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 you@example.com --dns edgedns -d '*.example.com' -d example.com runCredentials
| 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_ACCOUNT_SWITCH_KEY |
Target account ID when the DNS zone and credentials belong to different accounts |
AKAMAI_POLLING_INTERVAL |
Time between DNS propagation check in seconds (Default: 15) |
AKAMAI_PROPAGATION_TIMEOUT |
Maximum waiting time for DNS propagation in seconds (Default: 180) |
AKAMAI_TTL |
The TTL of the TXT record used for the DNS challenge in seconds (Default: 120) |
The environment variable names can be suffixed by _FILE to reference a file instead of a value.
More information here.
Akamai’s credentials are automatically detected in the following locations and prioritized in the following order:
- Section-specific environment variables (where
{SECTION}is specified usingAKAMAI_EDGERC_SECTION):
AKAMAI_{SECTION}_HOSTAKAMAI_{SECTION}_ACCESS_TOKENAKAMAI_{SECTION}_CLIENT_TOKENAKAMAI_{SECTION}_CLIENT_SECRET
- If
AKAMAI_EDGERC_SECTIONis not defined or is set todefault, environment variables:
AKAMAI_HOSTAKAMAI_ACCESS_TOKENAKAMAI_CLIENT_TOKENAKAMAI_CLIENT_SECRET
.edgercfile located atAKAMAI_EDGERC
- defaults to
~/.edgerc, sections can be specified usingAKAMAI_EDGERC_SECTION
- Default environment variables:
AKAMAI_HOSTAKAMAI_ACCESS_TOKENAKAMAI_CLIENT_TOKENAKAMAI_CLIENT_SECRET
See also:
- Setting up Akamai credentials
- .edgerc Format
- API Client Authentication
- Config from Env
- Manage many accounts