Tools to work with the Google DNS over HTTPS API in R https://cinc.rud.is/web/packages/gdns/
Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.

89 rader
2.6 KiB

8 år sedan
---
output: rmarkdown::github_document
8 år sedan
---
<!-- 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 år sedan
`gdns` : Tools to work with the Google DNS over HTTPS API
8 år sedan
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 år sedan
More info at <https://developers.google.com/speed/public-dns/docs/dns-over-https>.
8 år sedan
The following functions are implemented:
8 år sedan
- `bulk_query`: Vectorized query, returning only answers in a data frame
- `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
- `query`: Perform DNS over HTTPS queries using Google
- `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
8 år sedan
### 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")
str(query("rud.is"))
8 år sedan
str(query("example.com", "255")) # "ANY" query
str(query("microsoft.com", "MX"))
8 år sedan
str(query("google-public-dns-a.google.com", "TXT"))
8 år sedan
str(query("apple.com"))
8 år sedan
str(query("17.142.160.59", "PTR"))
8 år sedan
hosts <- c("rud.is", "dds.ec", "r-project.org", "rstudio.com", "apple.com")
8 år sedan
gdns::bulk_query(hosts)
```
### Test Results
```{r}
library(gdns)
library(testthat)
8 år sedan
date()
test_dir("tests/")
8 år sedan
```
### 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.