WebSupport
Configuration
To use this provider, add an entry to creds.json with TYPE set to WEBSUPPORT along with your WebSupport API key and secret. Both are generated in the Security section of the WebSupport admin console.
Example:
{
"websupport": {
"TYPE": "WEBSUPPORT",
"api_key": "your-api-key",
"secret": "your-api-secret"
}
}You can also use environment variables:
{
"websupport": {
"TYPE": "WEBSUPPORT",
"api_key": "$WEBSUPPORT_API_KEY",
"secret": "$WEBSUPPORT_SECRET"
}
}Metadata
This provider does not recognize any special metadata fields unique to WebSupport.
Usage
An example configuration:
Activation
DNSControl uses the WebSupport REST API v2 to manage your DNS records. Generate an API key and secret in the Security section of the admin console.
Authentication uses HTTP Basic auth where the username is the API key and the password is a per-request HMAC-SHA1 signature derived from the secret. The secret itself is never transmitted.
Notes and limitations
Zones must already exist. The API has no endpoint to create a zone or to enumerate all zones, so
create-domainsandget-zonesare not supported. Add domains through the WebSupport portal first.Supported record types:
A,AAAA,CNAME,MX,TXT, andSRV.Unsupported record types, due to WebSupport v2 API limitations:
NSβ the API silently ignores attempts to create NS records, so they are rejected to avoid an endless create loop. Apex nameservers are managed by WebSupport and are not exposed through the DNS record API.CAAβ the API does not return thetag/flagsof a CAA record on read, so the record cannot be managed without churn.ALIAS/ANAMEβ WebSupport only allowsANAMEat the apex and rejects it when other apex records exist, so it cannot be supported generically.LOC,NAPTR,PTR,SSHFP,TLSA,DS.
TXTrecords may not end in a space. The API silently strips trailing whitespace, so such records are rejected rather than churning forever.Null MX (RFC 7505) is not supported. A null MX has an empty target and the API rejects a record with empty
content, soMX("@", 0, ".")is rejected with a clear error.MX and SRV reads cost one extra API request each. WebSupport's record listing endpoints return
nullforpriority,portandweighton every record, even though the values are stored correctly and served in DNS. The provider re-reads eachMXandSRVrecord through the v1 single-record endpoint, which still reports them. This is a workaround for a bug on WebSupport's side and stops by itself once they fix the listing.The provider automatically resolves each domain to its numeric WebSupport service id (used internally by the v2 API); you only need to supply
api_keyandsecret.
Feature Summary
Provider Type
Official Support: β
DNS Provider: β
Registrar: β
Provider API
DNSSEC
AUTODNSSEC: βDNSKEY: βDS: β
Last updated