mirror/stackexchange-dnscontrol
1
0
Fork 0
mirror of https://github.com/StackExchange/dnscontrol.git synced 2024-05-11 05:55:12 +00:00
Code Issues Releases Activity
stackexchange-dnscontrol/docs/_providers/akamaiedgedns.md
Julius Rickert 20dad35167 Replace Jekyll highlight tags with fenced code blocks (#1412) 
* Replace Jekyll highlight tags with fenced code blocks

Replace Jekyll highlight tags with fenced code blocks.
Canonicalize javascript to js.
Correct highlighting languages.
Add highlighting to code blocks.
Remove leading $ from bash blocks.
Remove empty lines at start and end of code blocks.
Stripped trailing whitespace.

* Fix language of code highlighting
2022-02-17 12:22:31 -05:00

2.5 KiB
Raw Blame History

name title layout jsId
AkamaiEdgeDns Akamai Edge DNS Provider default AKAMAIEDGEDNS

Akamai Edge DNS Provider

"Akamai Edge DNS Provider" configures Akamai's Edge DNS service.

This provider interacts with Edge DNS via the Edge DNS Zone Management API.

Before you can use this provider, you need to create an "API Client" with authorization to use the Edge DNS Zone Management API.

See the "Get Started" section of Edge DNS Zone Management API, which says, "To enable this API, choose the API service named DNS—Zone Record Management, and set the access level to READ-WRITE."

Follow directions at Authenticate With EdgeGrid to generate the required credentials.

Configuration

In the credentials file (creds.json), you must provide the following:

"akamaiedgedns": {
    "client_secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "host": "akaa-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.xxxx.akamaiapis.net",
    "access_token": "akaa-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "client_token": "akaa-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "contract_id": "X-XXXX",
    "group_id": "NNNNNN"
}

Usage

A new zone created by DNSControl:

dnscontrol create-domains

automatically creates SOA and authoritative NS records.

Akamai assigns a unique set of authoritative nameservers for each contract. These authorities should be used as the NS records on all zones belonging to this contract.

The NS records for these authorities have a TTL of 86400.

Add:

NAMESERVER_TTL(86400)

modifier to the dnscontrol.js D() function so that DNSControl does not change the TTL of the authoritative NS records.

Example 'dnsconfig.js':

var REG_NONE = NewRegistrar('none', 'NONE');
var DNS_AKAMAIEDGEDNS = NewDnsProvider('akamaiedgedns', 'AKAMAIEDGEDNS');

D('example.com', REG_NONE, DnsProvider(DNS_AKAMAIEDGEDNS),
  NAMESERVER_TTL(86400),
  AUTODNSSEC_ON,
  AKAMAICDN("@", "www.preconfigured.edgesuite.net", TTL(20)),
  A('foo','1.2.3.4')
);

AKAMAICDN is a proprietary record type that is used to configure Zone Apex Mapping. The AKAMAICDN target must be preconfigured in the Akamai network.