table of contents
COREDNS-AZURE(7) | CoreDNS Plugins | COREDNS-AZURE(7) |
NAME¶
azure - enables serving zone data from Microsoft Azure DNS service.
DESCRIPTION¶
The azure plugin is useful for serving zones from Microsoft Azure DNS. The azure plugin supports all the DNS records supported by Azure, viz. A, AAAA, CNAME, MX, NS, PTR, SOA, SRV, and TXT record types. NS record type is not supported by azure private DNS.
SYNTAX¶
azure RESOURCE_GROUP:ZONE... {
tenant TENANT_ID
client CLIENT_ID
secret CLIENT_SECRET
subscription SUBSCRIPTION_ID
environment ENVIRONMENT
fallthrough [ZONES...]
access private }
- RESOURCE_GROUP:ZONE is the resource group to which the hosted zones belongs on Azure, and ZONE the zone that contains data.
- CLIENT_ID and CLIENT_SECRET are the credentials for Azure, and tenant specifies the TENANT_ID to be used. SUBSCRIPTION_ID is the subscription ID. All of these are needed to access the data in Azure.
- environment specifies the Azure ENVIRONMENT.
- fallthrough If zone matches and no record can be generated, pass request to the next plugin. If ZONES is omitted, then fallthrough happens for all zones for which the plugin is authoritative.
- access specifies if the zone is public or private. Default is public.
EXAMPLES¶
Enable the azure plugin with Azure credentials for private zones example.org, example.private:
example.org {
azure resource_group_foo:example.org resource_group_foo:example.private {
tenant 123abc-123abc-123abc-123abc
client 123abc-123abc-123abc-234xyz
subscription 123abc-123abc-123abc-563abc
secret mysecret
access private
} }
SEE ALSO¶
The Azure DNS Overview ⟨https://docs.microsoft.com/en-us/azure/dns/dns-overview⟩.
March 2021 | CoreDNS |