dnscontrol/docs/_providers/doh.md
2022-02-02 12:28:07 -05:00

1.3 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.

{% highlight json %} { "DNS-over-HTTPS": { "host": "cloudflare-dns.com" } } {% endhighlight %}

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:

{% highlight js %} var REG_MONITOR = NewRegistrar('DNS-over-HTTPS', 'DNSOVERHTTPS');

D("example.com", REG_MONITOR, NAMESERVER("ns1.example.com."), NAMESERVER("ns2.example.com."), ); {% endhighlight %}