In hrbrmstr/gdns: Tools to Work with Google's 'DNS'-over-'HTTPS' ('DoH') API

knitr::opts_chunk$set(
  message = FALSE,
  warning = FALSE,
  fig.retina = 2
)
options(width=120)

gdns

Tools to work with the Google DNS over HTTPS (DoH) API

Description

Traditional DNS queries and responses are sent over UDP or TCP without encryption. This is vulnerable to eavesdropping and spoofing (including DNS-based Internet filtering). Responses from recursive resolvers to clients are the most vulnerable to undesired or malicious changes, while communications between recursive resolvers and authoritative nameservers often incorporate additional protection.

To address this problem, Google Public DNS offers DNS resolution over an encrypted HTTPS connection. DNS-over-HTTPS greatly enhances privacy and security between a client and a recursive resolver, and complements DNSSEC to provide end-to-end authenticated DNS lookups.

More info at https://developers.google.com/speed/public-dns/docs/doh/.

The following functions are implemented:

Core:

query / dig: Perform DNS over HTTPS queries using Google
bulk_query: Vectorized query, returning only answers in a data frame
as.data.frame: Coerce a gdns query response answer to a data frame

Helpers:

has_spf: Test for whether a DNS TXT record is an SPF record
is_hard_fail: SPF "all" type test
is_soft_fail: SPF "all" type test
passes_all: SPF "all" type test
spf_exists: SPF field extraction functions
spf_includes: SPF field extraction functions
spf_ipv4s: SPF field extraction functions
spf_ipv6s: SPF field extraction functions
spf_ptrs: SPF field extraction functions
split_spf: Split out all SPF records in a domain's TXT record

IANA Datasets:

dns_classes: DNS CLASSes (dataset)
dns_glob_names: Underscored and Globally Scoped DNS Node Names (dataset)
dns_opcodes: DNS OpCodes (dataset)
dns_rcodes: DNS RCODEs (dataset)
edns0_option_codes: DNS EDNS0 Option Codes (OPT) (dataset)
rrtypes: Resource Record (RR) TYPEs (dataset)

Installation

Any of the following:

install.packages("gdns", repos = "https://cinc.rud.is")
devtools::install_git("https://git.rud.is/hrbrmstr/gdns")
devtools::install_git("https://git.sr.ht/~rbrmstr/gdns")
devtools::install_bitbucket("hrbrmstr/gdns")
devtools::install_gitlab("hrbrmstr/gdns")
devtools::install_github("hrbrmstr/gdns")

options(width=120)

Usage

library(gdns)
library(tibble) # for printing

# current verison
packageVersion("gdns")

str(query("rud.is"))

query("rud.is") %>% 
  as.data.frame()

str(dig("example.com", "255")) # "ANY" query

query("microsoft.com", "MX") %>% 
  as.data.frame()

as.data.frame(query("apple.com"))

as.data.frame(dig("17.142.160.59", "PTR"))

hosts <- c("rud.is", "dds.ec", "r-project.org", "rstudio.com", "apple.com")

gdns::bulk_query(hosts)