Tools to work with the Google DNS over HTTPS API in R https://cinc.rud.is/web/packages/gdns/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

72 lines
2.0 KiB

8 years ago
---
output: rmarkdown::github_document
8 years ago
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
```
[![Travis-CI Build Status](https://travis-ci.org/hrbrmstr/gdns.svg?branch=master)](https://travis-ci.org/hrbrmstr/gdns)
8 years ago
`gdns` : Tools to work with the Google DNS over HTTPS API
8 years ago
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.
8 years ago
More info at <https://developers.google.com/speed/public-dns/docs/dns-over-https>.
8 years ago
The following functions are implemented:
8 years ago
- `query` : perform Google DNS query for a single host (retreives metadata & answer)
- `bulk_query` : perform bulk host queries, returning a \code{data.frame} of only answers (no metadata)
8 years ago
### News
- Version 0.1.0.9000 released
### Installation
```{r eval=FALSE}
devtools::install_github("hrbrmstr/gdns")
```
```{r echo=FALSE, message=FALSE, warning=FALSE, error=FALSE}
options(width=120)
```
### Usage
```{r}
library(gdns)
# current verison
packageVersion("gdns")
```
### Test Results
```{r}
library(gdns)
library(testthat)
date()
test_dir("tests/")
8 years ago
hosts <- c("rud.is", "dds.ec", "r-project.org", "rstudio.com", "apple.com")
8 years ago
8 years ago
gdns::bulk_query(hosts)
8 years ago
```
### Code of Conduct
Please note that this project is released with a [Contributor Code of Conduct](CONDUCT.md).
By participating in this project you agree to abide by its terms.