74 lines
2.1 KiB
Groff
74 lines
2.1 KiB
Groff
.\" Generated by Mmark Markdown Processer - mmark.miek.nl
|
|
.TH "COREDNS-AZURE" 7 "March 2021" "CoreDNS" "CoreDNS Plugins"
|
|
|
|
.SH "NAME"
|
|
.PP
|
|
\fIazure\fP - enables serving zone data from Microsoft Azure DNS service.
|
|
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
The azure plugin is useful for serving zones from Microsoft Azure DNS. The \fIazure\fP 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.
|
|
|
|
.SH "SYNTAX"
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
azure RESOURCE\_GROUP:ZONE... {
|
|
tenant TENANT\_ID
|
|
client CLIENT\_ID
|
|
secret CLIENT\_SECRET
|
|
subscription SUBSCRIPTION\_ID
|
|
environment ENVIRONMENT
|
|
fallthrough [ZONES...]
|
|
access private
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.IP \(bu 4
|
|
\fBRESOURCE_GROUP:ZONE\fP is the resource group to which the hosted zones belongs on Azure,
|
|
and \fBZONE\fP the zone that contains data.
|
|
.IP \(bu 4
|
|
\fBCLIENT_ID\fP and \fBCLIENT_SECRET\fP are the credentials for Azure, and \fB\fCtenant\fR specifies the
|
|
\fBTENANT_ID\fP to be used. \fBSUBSCRIPTION_ID\fP is the subscription ID. All of these are needed
|
|
to access the data in Azure.
|
|
.IP \(bu 4
|
|
\fB\fCenvironment\fR specifies the Azure \fBENVIRONMENT\fP.
|
|
.IP \(bu 4
|
|
\fB\fCfallthrough\fR If zone matches and no record can be generated, pass request to the next plugin.
|
|
If \fBZONES\fP is omitted, then fallthrough happens for all zones for which the plugin is
|
|
authoritative.
|
|
.IP \(bu 4
|
|
\fB\fCaccess\fR specifies if the zone is \fB\fCpublic\fR or \fB\fCprivate\fR. Default is \fB\fCpublic\fR.
|
|
|
|
|
|
.SH "EXAMPLES"
|
|
.PP
|
|
Enable the \fIazure\fP plugin with Azure credentials for private zones \fB\fCexample.org\fR, \fB\fCexample.private\fR:
|
|
|
|
.PP
|
|
.RS
|
|
|
|
.nf
|
|
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
|
|
}
|
|
}
|
|
|
|
.fi
|
|
.RE
|
|
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
The Azure DNS Overview
|
|
\[la]https://docs.microsoft.com/en-us/azure/dns/dns-overview\[ra].
|
|
|