2020-07-08 22:16:54 +02:00
|
|
|
Name = "Akamai EdgeDNS"
|
|
|
|
|
Description = '''
|
2020-09-30 00:27:08 +02:00
|
|
|
Akamai edgedns supersedes FastDNS; implementing a DNS provider for solving the DNS-01 challenge using Akamai EdgeDNS
|
2020-07-08 22:16:54 +02:00
|
|
|
'''
|
|
|
|
|
URL = "https://www.akamai.com/us/en/products/security/edge-dns.jsp"
|
|
|
|
|
Code = "edgedns"
|
2024-10-14 13:14:05 +02:00
|
|
|
Aliases = ["fastdns"] # "fastdns" is for compatibility with v3, must be dropped in v5
|
2020-07-08 22:16:54 +02:00
|
|
|
Since = "v3.9.0"
|
|
|
|
|
|
|
|
|
|
Example = '''
|
|
|
|
|
AKAMAI_CLIENT_SECRET=abcdefghijklmnopqrstuvwxyz1234567890ABCDEFG= \
|
|
|
|
|
AKAMAI_CLIENT_TOKEN=akab-mnbvcxzlkjhgfdsapoiuytrewq1234567 \
|
|
|
|
|
AKAMAI_HOST=akab-aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa.luna.akamaiapis.net \
|
|
|
|
|
AKAMAI_ACCESS_TOKEN=akab-1234567890qwerty-asdfghjklzxcvtnu \
|
2022-06-17 00:25:42 +02:00
|
|
|
lego --email you@example.com --dns edgedns --domains my.example.org run
|
2020-07-08 22:16:54 +02:00
|
|
|
'''
|
|
|
|
|
|
2021-02-21 12:56:56 +02:00
|
|
|
Additional = '''
|
2023-07-29 12:59:24 +02:00
|
|
|
Akamai's credentials are automatically detected in the following locations and prioritized in the following order:
|
2021-02-21 12:56:56 +02:00
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
- [Setting up Akamai credentials](https://developer.akamai.com/api/getting-started)
|
|
|
|
|
- [.edgerc Format](https://developer.akamai.com/legacy/introduction/Conf_Client.html#edgercformat)
|
|
|
|
|
- [API Client Authentication](https://developer.akamai.com/legacy/introduction/Client_Auth.html)
|
2023-08-19 19:03:45 +02:00
|
|
|
- [Config from Env](https://github.com/akamai/AkamaiOPEN-edgegrid-golang/blob/master/pkg/edgegrid/config.go#L118)
|
2021-02-21 12:56:56 +02:00
|
|
|
'''
|
|
|
|
|
|
2020-07-08 22:16:54 +02:00
|
|
|
[Configuration]
|
|
|
|
|
[Configuration.Credentials]
|
2021-02-21 12:56:56 +02:00
|
|
|
AKAMAI_HOST = "API host, managed by the Akamai EdgeGrid client"
|
|
|
|
|
AKAMAI_CLIENT_TOKEN = "Client token, managed by the Akamai EdgeGrid client"
|
|
|
|
|
AKAMAI_CLIENT_SECRET = "Client secret, managed by the Akamai EdgeGrid client"
|
|
|
|
|
AKAMAI_ACCESS_TOKEN = "Access 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"
|
2020-07-08 22:16:54 +02:00
|
|
|
[Configuration.Additional]
|
|
|
|
|
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"
|
|
|
|
|
|
|
|
|
|
[Links]
|
|
|
|
|
API = "https://developer.akamai.com/api/cloud_security/edge_dns_zone_management/v2.html"
|
|
|
|
|
GoClient = "https://github.com/akamai/AkamaiOPEN-edgegrid-golang"
|
|
|
|
|
|
|
|
|
|
|
