Constellix
Configuration
To use this provider, add an entry to creds.json with TYPE set to CONSTELLIX along with your Constellix API key and secret key.
Example:
{
"constellix": {
"TYPE": "CONSTELLIX",
"api_key": "your-constellix-api-key",
"secret_key": "your-constellix-secret-key"
}
}You can also use environment variables:
export CONSTELLIX_API_KEY=XXXXXXXXX
export CONSTELLIX_SECRET_KEY=YYYYYYYYY{
"constellix": {
"TYPE": "CONSTELLIX",
"api_key": "$CONSTELLIX_API_KEY",
"secret_key": "$CONSTELLIX_SECRET_KEY"
}
}Metadata
This provider does not recognize any special metadata fields unique to Constellix.
Usage
An example configuration:
Activation
DNSControl talks to the Constellix DNS v4 API, which needs an API key and a secret key.
Sign in to the Constellix management portal.
Open your user profile (Manage Profile, or Edit Profile under your username) and choose Generate API Keys.
Copy both keys into
creds.jsonas shown above. The secret key is only shown to the user who generated it, so save it when it is displayed.
Every request is signed with a token that embeds the current time. If the API rejects the keys (HTTP 401), check the keys and make sure the system clock is correct.
Supported record types
A
IPv4 address record
AAAA
IPv6 address record
ALIAS
Constellix ANAME record
CAA
Certification Authority Authorization record (tags issue, issuewild and iodef)
CNAME
Canonical name (alias) record
MX
Mail exchange record
NS
Name server record
PTR
Pointer record, in reverse zones only
SRV
Service record
TXT
Text record
No other record type is supported.
New domains
If a domain does not exist in your Constellix account, DNSControl will add it with the push command (or create-domains), using Constellix's defaults. The new zone is read back once for its nameservers. If that read fails, the run stops with an error saying that the zone was created but is not readable yet; run push again.
Limitations
Rate limit
The Constellix API allows a window of 180 units per 60 seconds, shared by the whole account: every client using any API key of the account draws from the same window. One request can consume several units, so the effective request rate can be well below 180 requests per minute.
When the API reports that the window is used up (HTTP 429, or a response that says no units remain), DNSControl pauses all of its requests until the window resets, as the response headers say, and then sends the rejected request again. It prints a notice such as CONSTELLIX: rate limit reached, waiting 43s while it waits. A single request gives up after waiting five minutes in total.
Each request takes one to two seconds, so a single zone never comes near the limit. Runs over many zones, or on an account where other automation uses the API at the same time, can be slow. For accounts with many zones, run DNSControl with a small --cmax, such as 3 to 5, so that fewer requests compete for the window.
Records DNSControl does not manage
Constellix records can use features that DNSControl does not model. Rather than overwrite them on the next change, reading a zone fails with an error that names the record when it finds one of these:
a record in a mode other than standard: failover, pools or round-robin failover
a record in a Global Traffic Director (GTD) region other than the default one
an IP filter
GeoProximity
a disabled record, or a record with a disabled value
a record without any values
a record type DNSControl does not manage with this provider, such as
HTTPredirects,NAPTR,RP,HINFO,CERTorSPF
A zone that is linked to a template is refused as a whole.
Convert the record to a standard record, or remove it, in the Constellix portal (or unlink the template), then run DNSControl again.
Because of this, dnscontrol get-zones ... all with a format that reads records (js, djs, zone, tsv) stops at the first zone that uses one of these features. --format=nameonly does not read records and lists every zone. On such an account, bootstrap dnsconfig.js zone by zone.
Apex NS records
Constellix serves its own nameservers at the zone apex without listing them as records, and reports them as the zone's nameservers.
Apex
NSrecords that point at the zone's own Constellix nameservers are dropped from the configuration, since Constellix serves them anyway.Any other apex
NSrecord is managed like an ordinary record, which allows dual hosting with a second DNS provider. Constellix serves such records in addition to its own nameservers, always with a TTL of 86400, whatever TTL is configured; the configured TTL is what DNSControl compares, so this causes no change on the next run.If the zone stores an apex
NSrecord that repeats one of Constellix's own nameservers (created in the portal, for example), DNSControl removes that value once. The answers do not change, because Constellix serves its own nameservers anyway.
NS records pointing at the zone apex
Constellix cannot store an NS record whose target is the zone itself, such as NS("foo", "example.com.") in example.com: the API answers with an internal server error. DNSControl reports such a record as an error before contacting the API. Point the record at another name of the zone (with an A or AAAA record) or at a name outside the zone instead.
ALIAS
ALIAS records are written as Constellix ANAME records with skipLookup set, so Constellix accepts a target that does not resolve yet, such as one created in the same push. A target that never resolves (a typo, for example) is accepted too, and the record then answers nothing.
Constellix refuses an ALIAS at the apex next to an A record at the apex, and the push fails with the API's error.
PTR
PTR records are supported in reverse zones (in-addr.arpa, ip6.arpa) only. In a forward zone Constellix refuses them, and the push fails with the API's error The name is not valid.
TXT
TXT values are written in presentation format. Constellix splits a value longer than 255 characters into several strings itself, sometimes at another place than DNSControl would; DNSControl compares the joined text, so this causes no change on the next run.
TTL
Constellix accepts TTLs up to 2147483647. A larger TTL is lowered to 2147483647.
DNSSEC
AUTODNSSEC_ON is not supported: the Constellix v4 API has no DNSSEC endpoints.
Feature Summary
Provider Type
Official Support: β
DNS Provider: β
Registrar: β
Provider API
DNSSEC
AUTODNSSEC: βDNSKEY: βDS: β
Last updated