community.missing_collection.doh_module.rst

community.missing_collection.doh

DNS Lookup over HTTPS.

Version added: 0.4.0

• Synopsis
• Requirements
• Parameters
• Examples
• Return Values
• Status

Synopsis

• DNS Lookup over HTTPS from various Public DOH Servers like Google/Cloudflare/Quad9.
• https://developers.cloudflare.com/1.1.1.1/encrypted-dns/dns-over-https/make-api-requests/dns-json
• https://developers.google.com/speed/public-dns/docs/doh/json
• https://www.quad9.net/news/blog/doh-with-quad9-dns-servers/

Requirements

The below requirements are needed on the host that executes this module.

• requests

Parameters

Parameter	Choices/Defaults	Comments
cd boolean	Choices: no ← yes	set to disable validation.
do boolean	Choices: no yes ←	set if client wants DNSSEC data.
domain_name string / required		domain name or hostname for lookup.
source string	Choices: google cloudflare ← quad9	DNS over HTTPS can be queried from Google/Cloudflare/Quad9.
type string	Default: "A"	type of dns lookup.

Examples

- name: fetch A record from cloudflare DNS over HTTPS
  community.missing_collection.doh:
    source: "cloudflare"
    domain_name: "example.com"
    type: "A"

- name: fetch NS record from Google DNS over HTTPS
  community.missing_collection.doh:
    source: "google"
    name: "example.com"
    type: "NS"

- name: fetch mail record from Quad9 DNS over HTTPS
  community.missing_collection.doh:
    source: "quad9"
    name: "example.com"
    type: "MX"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
result dictionary	when success.	result of the api request. Sample: {'Status': 0, 'TC': False, 'RD': True, 'RA': True, 'AD': True, 'CD': False, 'Question': [{'name': 'example.com.', 'type': 28}], 'Answer': [{'name': 'example.com.', 'type': 28, 'TTL': 1726, 'data': '2606:2800:220:1:248:1893:25c8:1946'}]}

Status

Authors

• Davinder Pal (@116davinder) <dpsangwal@gmail.com>