dnscontrol/docs/_providers/doh.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

1.2 KiB

name title layout jsId
DNS-over-HTTPS DNS-over-HTTPS Provider default DNSOVERHTTPS

DNS-over-HTTPS Provider

This is a read-only/monitoring "registrar". It does a DNS NS lookup to confirm the nameserver servers are correct. This "registrar" is unable to update/correct the NS servers but will alert you if they are incorrect. A common use of this provider is when the domain is with a registrar that does not have an API.

Configuration

The DNS-over-HTTPS provider does not require anything in creds.json. By default, it uses Google Public DNS however you may configure an alternative RFC 8484 DoH provider.

{
  "DNS-over-HTTPS": {
    "host": "cloudflare-dns.com"
  }
}

Some common DoH providers are cloudflare-dns.com (Cloudflare), 9.9.9.9 (Quad9), and dns.google (Google Public DNS).

Metadata

This provider does not recognize any special metadata fields unique to DOH.

Usage

Example Javascript:

var REG_MONITOR = NewRegistrar('DNS-over-HTTPS', 'DNSOVERHTTPS');

D("example.com", REG_MONITOR,
  NAMESERVER("ns1.example.com."),
  NAMESERVER("ns2.example.com."),
);